[{"data":1,"prerenderedAt":1123},["ShallowReactive",2],{"header:help":3,"footer:default":67,"story:navigation\u002Fsearch:help":250,"story:help\u002Fcategories":288,"story:help\u002Farticles\u002Fcustom-tax-endpoint-reference":314,"no-guide:custom-tax-endpoint-reference":59,"article:\u002Fhelp\u002Farticles\u002Fcustom-tax-endpoint-reference":863,"story:contact":879,"help:tree:78cc0360-18c2-439f-a15e-48b603c3e9bc":1068,"_apollo:default":1122},{"name":4,"created_at":5,"published_at":6,"updated_at":7,"id":8,"uuid":9,"content":10,"slug":57,"full_slug":58,"sort_by_date":59,"position":60,"tag_list":61,"is_startpage":24,"parent_id":62,"meta_data":59,"group_id":63,"first_published_at":64,"release_id":59,"lang":65,"path":59,"alternates":66,"default_full_slug":59,"translated_slugs":59},"Help Center Header","2024-08-09T18:06:34.939Z","2024-10-21T21:58:39.217Z","2024-10-21T21:58:39.232Z",10082752,"3e9b88f7-c163-4657-a2f2-62532d600fad",{"_uid":11,"link":12,"badge":16,"items":17,"title":13,"buttons":50,"new_tab":24,"submenu":51,"alignment":13,"component":52,"badge_link":53,"top_menu_items":56},"e5645a1a-f991-40e8-8d67-e40ebc082b5a",{"id":13,"url":13,"linktype":14,"fieldtype":15,"cached_url":13},"","story","multilink","Help Center",[18,27,34,39,44],{"_uid":19,"link":20,"title":23,"new_tab":24,"submenu":25,"component":26},"5cbe2861-1f49-4166-97da-a4dddd8105e3",{"id":21,"url":13,"linktype":14,"fieldtype":15,"cached_url":22},"4c0a2d99-ec30-4579-8ef1-6bf5564d4839","help\u002Fcategories\u002F","Articles",false,[],"header___item",{"_uid":28,"link":29,"title":32,"new_tab":33,"component":26},"1c8edeb5-b9e9-4cb8-b1c6-c1f292f7d7cd",{"id":13,"url":30,"linktype":31,"fieldtype":15,"cached_url":30},"https:\u002F\u002Fwiki.foxycart.com\u002F","url","Documentation",true,{"_uid":35,"link":36,"title":38,"new_tab":33,"component":26},"8d7df70e-f087-4da0-b616-6f0e9a5af35c",{"id":13,"url":37,"linktype":31,"fieldtype":15,"cached_url":37},"https:\u002F\u002Fapi.foxycart.com\u002F","API Documentation",{"_uid":40,"link":41,"title":43,"new_tab":33,"component":26},"f76e7944-23d5-4652-87e4-cdae79272762",{"id":13,"url":42,"linktype":31,"fieldtype":15,"cached_url":42},"https:\u002F\u002Fstatus.foxy.io\u002F","System Status",{"_uid":45,"link":46,"title":49,"new_tab":24,"component":26},"0de16771-4c84-466c-a1da-d8568113c71f",{"id":47,"url":13,"linktype":14,"fieldtype":15,"cached_url":48},"01e4e370-f9b9-45af-8fa9-f15540699b0d","contact","Contact Us",[],[],"header",{"id":54,"url":13,"linktype":14,"fieldtype":15,"cached_url":55},"4a679eb7-662d-4ea4-a976-5a2acbf0b663","help\u002F",[],"help-header","navigation\u002Fhelp-header",null,20,[],10082747,"71b81c2e-5e09-48a1-a397-a3c72fcd344a","2022-09-21T14:50:25.655Z","default",[],{"name":68,"created_at":69,"published_at":70,"updated_at":71,"id":72,"uuid":73,"content":74,"slug":243,"full_slug":244,"sort_by_date":59,"position":245,"tag_list":246,"is_startpage":24,"parent_id":62,"meta_data":59,"group_id":247,"first_published_at":248,"release_id":59,"lang":65,"path":59,"alternates":249,"default_full_slug":59,"translated_slugs":59},"Default Footer","2024-08-09T18:06:59.024Z","2025-09-04T06:24:46.223Z","2025-09-04T06:24:46.241Z",10082753,"e59e67ac-248a-482f-84a1-53d4f318186a",{"_uid":75,"about":76,"logos":77,"socials":82,"sections":108,"component":225,"cta_title":226,"bottom_links":227,"cta_subtitle":241,"cta_button_link":242,"cta_button_text":183},"830983f5-c4c4-43c8-b150-86a5e3fa6dc8","Foxy’s hosted cart & payment page allow you to sell anything, using your existing website or platform.",[78],{"id":79,"alt":13,"name":13,"focus":13,"title":13,"filename":80,"copyright":13,"fieldtype":81},14760,"https:\u002F\u002Fa-us.storyblok.com\u002Ff\u002F1001040\u002Fx\u002F3b030847ec\u002Fb-corp.svg","asset",[83,90,96,102],{"_uid":84,"icon":85,"link":86,"name":88,"component":89},"faf0a618-ea94-42ea-9182-03be18c43216","fa-facebook",{"id":13,"url":87,"linktype":31,"fieldtype":15,"cached_url":87},"https:\u002F\u002Fwww.facebook.com\u002Ffoxycart","Facebook","footer___social",{"_uid":91,"icon":92,"link":93,"name":95,"component":89},"14309c18-7e79-423e-b375-34555bac0811","fa-instagram",{"id":13,"url":94,"linktype":31,"fieldtype":15,"cached_url":94},"https:\u002F\u002Fwww.instagram.com\u002Ffoxy_io","Instagram",{"_uid":97,"icon":98,"link":99,"name":101,"component":89},"8f7fe7cf-0dd3-4596-8334-226ea466716a","fa-linkedin",{"id":13,"url":100,"linktype":31,"fieldtype":15,"cached_url":100},"https:\u002F\u002Fwww.linkedin.com\u002Fcompany\u002Ffoxycart.com","LinkedIn",{"_uid":103,"icon":104,"link":105,"name":107,"component":89},"90a675b4-dd97-40b5-be09-00a87223d4c5","fa-youtube",{"id":13,"url":106,"linktype":31,"fieldtype":15,"cached_url":106},"https:\u002F\u002Fwww.youtube.com\u002Fuser\u002Ffoxycart","Youtube",[109,139,184,206],{"_uid":110,"name":111,"items":112,"component":138},"82849945-282f-488c-b18d-a8d2252f514a","Company",[113,120,126,132],{"_uid":114,"link":115,"title":118,"new_tab":24,"component":119},"1f699ab1-938b-4d9d-9825-aabcbe6f57fe",{"id":116,"url":13,"linktype":14,"fieldtype":15,"cached_url":117},"63634293-a749-4226-9439-9f38ee6dcda0","about-us","About Us","footer___menu_items",{"_uid":121,"link":122,"title":125,"new_tab":24,"component":119},"b26b00f1-a0e7-4be2-8ab3-428b8cc841f8",{"id":123,"url":13,"linktype":14,"fieldtype":15,"cached_url":124},"26cb7c55-faed-4a77-a291-1552d4111b3e","how-foxy-works","How Foxy Works",{"_uid":127,"link":128,"title":131,"new_tab":24,"component":119},"b40c68a0-1ceb-4226-9515-6176534f61fe",{"id":129,"url":13,"linktype":14,"fieldtype":15,"cached_url":130},"dc6657d7-7f4f-4c0d-b781-e971b038ee26","for-good","Foxy For Good",{"_uid":133,"link":134,"title":137,"new_tab":24,"component":119},"3ad0c134-bef9-4fff-b891-e09f16109036",{"id":135,"url":13,"linktype":14,"fieldtype":15,"cached_url":136},"23cae210-baf4-4588-9862-d09f4f52ccd2","brand-assets","Brand Assets","footer___section",{"_uid":140,"name":141,"items":142,"component":138},"a6805fa8-ac60-47f1-b8f0-f27aded0afbe","Product",[143,149,155,161,167,173,179],{"_uid":144,"link":145,"title":148,"new_tab":24,"component":119},"b39c8a4e-2383-486f-b76a-11fbb15d8134",{"id":146,"url":13,"linktype":14,"fieldtype":15,"cached_url":147},"bb04690f-fe98-4ce6-80be-05b950f2364f","features\u002F","Features",{"_uid":150,"link":151,"title":154,"new_tab":24,"component":119},"64f8a41f-c181-433d-bc0a-fc94e71ecbf6",{"id":152,"url":13,"linktype":14,"fieldtype":15,"cached_url":153},"c450c58d-761d-48c0-a9af-0b064611689b","pricing","Pricing",{"_uid":156,"link":157,"title":160,"new_tab":24,"component":119},"6e0b287f-fd8c-4146-9e0e-0ab0b5c9ce3c",{"id":158,"url":13,"linktype":14,"fieldtype":15,"cached_url":159},"fab20ad9-e76a-4947-b709-3a6fdfa88028","blog\u002Fcategories\u002Fproduct-updates","Product Updates",{"_uid":162,"link":163,"title":166,"new_tab":24,"component":119},"47e5a074-a6b5-4f1c-8c2f-89a2ae9f83eb",{"id":164,"url":13,"linktype":14,"fieldtype":15,"cached_url":165},"d2c83612-d611-47f3-a3b4-ca7fe08540b8","changelogs\u002F","Changelogs",{"_uid":168,"link":169,"title":172,"new_tab":24,"component":119},"b5c08774-542f-4ffd-b357-c94d674488b9",{"id":170,"url":13,"linktype":14,"fieldtype":15,"cached_url":171},"08876121-0df3-4ed9-aa11-902b3e41cd02","whats-next","What's Next",{"_uid":174,"link":175,"title":178,"new_tab":24,"component":119},"9c2704ed-6d9f-43e1-9e67-c8d91c083288",{"id":176,"url":13,"linktype":14,"fieldtype":15,"cached_url":177},"056a7857-b18f-4025-8f97-91a38fc19bc8","compare\u002F","Compare",{"_uid":180,"link":181,"title":183,"new_tab":24,"component":119},"5f2db35b-674b-406a-8fa7-d246633af9fe",{"id":13,"url":182,"linktype":31,"fieldtype":15,"cached_url":182},"https:\u002F\u002Fadmin.foxy.io\u002Fsign-up","Try Foxy Free",{"_uid":185,"name":186,"items":187,"component":138},"63fa1f29-4252-4640-9922-fe310e69e54a","Security",[188,194,200],{"_uid":189,"link":190,"title":193,"new_tab":24,"component":119},"1158ddb6-9eb0-466f-8eb6-7ca2ae66c8b8",{"id":191,"url":13,"linktype":14,"fieldtype":15,"cached_url":192},"1f58fb2c-8681-4742-b6e8-09999beae9f6","security-contact","Security Contact",{"_uid":195,"link":196,"title":199,"new_tab":24,"component":119},"9a79c54a-6022-4dfd-854b-766f5e4703ba",{"id":197,"url":13,"linktype":14,"fieldtype":15,"cached_url":198},"55cbfcc3-425a-4261-8037-54e919851d2d","pci","PCI Compliance",{"_uid":201,"link":202,"title":205,"new_tab":24,"component":119},"0b85f5b6-9534-4071-b323-b39d053dd4d7",{"id":203,"url":13,"linktype":14,"fieldtype":15,"cached_url":204},"c3ac0fe3-83e2-4879-afbd-d4c83e1590df","help\u002Farticles\u002Four-official-domains-public-code","Domains & Codebases",{"_uid":207,"name":208,"items":209,"component":138},"998ded67-d107-49f4-8154-ca6be51671ec","Support",[210,213,216,219,222],{"_uid":211,"link":212,"title":16,"new_tab":24,"component":119},"594ffd35-3049-4004-bb08-0db568ebd819",{"id":54,"url":13,"linktype":14,"fieldtype":15,"cached_url":55},{"_uid":214,"link":215,"title":32,"new_tab":33,"component":119},"0a1a55ab-a985-4f9d-8b42-26da714d0c1c",{"id":13,"url":30,"linktype":31,"fieldtype":15,"cached_url":30},{"_uid":217,"link":218,"title":38,"new_tab":33,"component":119},"61e0b7c8-aadf-419b-a339-b3ccabc65bf4",{"id":13,"url":37,"linktype":31,"fieldtype":15,"cached_url":37},{"_uid":220,"link":221,"title":43,"new_tab":33,"component":119},"fd67a89e-1c54-4d31-94b5-64be999062d6",{"id":13,"url":42,"linktype":31,"fieldtype":15,"cached_url":42},{"_uid":223,"link":224,"title":49,"new_tab":24,"component":119},"231a6f71-e996-4ad4-b033-d4d5542f34f0",{"id":47,"url":13,"linktype":14,"fieldtype":15,"cached_url":48},"footer","Get started with our *unlimited free trial*.",[228,235],{"_uid":229,"link":230,"text":233,"component":234},"f0b77210-2632-45a2-8436-e57cad84d01a",{"id":231,"url":13,"linktype":14,"fieldtype":15,"cached_url":232},"60ba16a2-c1f4-485f-b978-8d2eeeafbf5a","terms-of-service","Terms of Service","footer___bottom_links",{"_uid":236,"link":237,"text":240,"component":234},"4bd497b0-993f-4b4d-a5b7-8a49c7c8fec9",{"id":238,"url":13,"linktype":14,"fieldtype":15,"cached_url":239},"332302b9-1d18-4016-b9c8-9b33c72d782b","privacy-policy","Privacy Policy","No credit card required.",{"id":13,"url":182,"linktype":31,"fieldtype":15,"cached_url":182},"default-footer","navigation\u002Fdefault-footer",50,[],"11006268-07f9-41e9-96f3-c51fb723399d","2022-09-21T20:39:02.357Z",[],{"name":251,"created_at":252,"published_at":253,"updated_at":254,"id":255,"uuid":256,"content":257,"slug":279,"full_slug":282,"sort_by_date":59,"position":283,"tag_list":284,"is_startpage":24,"parent_id":62,"meta_data":59,"group_id":285,"first_published_at":286,"release_id":59,"lang":65,"path":59,"alternates":287,"default_full_slug":59,"translated_slugs":59},"Search","2024-10-21T22:08:54.973Z","2025-05-26T09:17:25.790Z","2025-05-26T09:17:25.804Z",13592003,"14cbc359-9ac1-4a7a-a8de-ad4ac8ef26d4",{"_uid":258,"name":251,"indices":259,"summary":13,"component":279,"primary_image":280},"5e4a56e8-76f1-4790-b3a7-70f1be97d042",[260,265,269,274],{"key":261,"_uid":262,"icon":13,"name":263,"component":264},"all","c12a3210-7323-4273-8217-5215e52efe84","All","index",{"key":266,"_uid":267,"icon":268,"name":23,"component":264},"help_center_article","5acff080-95e4-44d3-8dcf-1b19720af382","fa-file-alt",{"key":270,"_uid":271,"icon":272,"name":273,"component":264},"help_center_guide","b8fbc206-c083-471e-a1f0-0ebeb90a669d","fa-book","Guides",{"key":275,"_uid":276,"icon":277,"name":278,"component":264},"blog_post","23419e83-2e56-4c4c-8a05-9fd1b3c9a9bd","fa-file-image","Blog Posts","search",{"id":59,"alt":59,"name":13,"focus":59,"title":59,"source":59,"filename":13,"copyright":59,"fieldtype":81,"meta_data":281},{},"navigation\u002Fsearch",60,[],"11e1fd31-95cd-4fc9-b736-8b8910663e6c","2024-10-21T23:17:05.904Z",[],{"name":23,"created_at":289,"published_at":290,"updated_at":291,"id":292,"uuid":21,"content":293,"slug":307,"full_slug":22,"sort_by_date":59,"position":308,"tag_list":309,"is_startpage":33,"parent_id":310,"meta_data":59,"group_id":311,"first_published_at":312,"release_id":59,"lang":65,"path":59,"alternates":313,"default_full_slug":59,"translated_slugs":59},"2022-09-19T14:42:29.685Z","2024-07-30T18:17:22.506Z","2024-07-30T18:17:22.525Z",2660,{"_uid":294,"icon":13,"name":23,"guides":295,"pinned":24,"summary":296,"category":13,"component":297,"blog_posts":298,"content_hub":24,"icon_custom":299,"case_studies":300,"faq_sections":301,"help_articles":302,"featured_guides":303,"mailbox_category":13,"featured_articles":304,"featured_blog_posts":305,"featured_case_studies":306},"d6dae89a-907a-4bf7-82de-fe2ba875ee6e",[],"Get your questions answered with our browsable knowledge base.","help_center_category",[],{"id":59,"alt":59,"name":13,"focus":59,"title":59,"filename":13,"copyright":59,"fieldtype":81},[],[],[],[],[],[],[],"categories",530,[],2658,"19ebcdd2-027f-47f5-9a5b-a8992c959578","2022-09-19T16:24:39.219Z",[],{"name":315,"created_at":316,"published_at":317,"updated_at":318,"id":319,"uuid":320,"content":321,"slug":855,"full_slug":856,"sort_by_date":59,"position":857,"tag_list":858,"is_startpage":24,"parent_id":859,"meta_data":59,"group_id":860,"first_published_at":861,"release_id":59,"lang":65,"path":59,"alternates":862,"default_full_slug":59,"translated_slugs":59},"Custom Tax Endpoint Reference","2026-07-06T19:40:23.577Z","2026-07-06T20:33:27.683Z","2026-07-06T20:33:27.704Z",195285907839567,"78cc0360-18c2-439f-a15e-48b603c3e9bc",{"_uid":322,"body":323,"name":315,"image":850,"pinned":24,"summary":852,"category":853,"component":266,"related_articles":854},"c241b4db-e9c4-4863-b9df-02bae57fb0cf",{"type":324,"content":325},"doc",[326,334,351,356,368,493,498,543,548,783,788,793,799,804,809,814,819,830,835,845],{"type":327,"attrs":328,"content":330},"heading",{"level":329,"textAlign":59},2,[331],{"text":332,"type":333},"Overview","text",{"type":335,"attrs":336,"content":337},"paragraph",{"textAlign":59},[338,340,349],{"text":339,"type":333},"This is a lookup reference for the custom tax endpoint. For setup, see ",{"text":341,"type":333,"marks":342},"Set up a custom tax endpoint",[343],{"type":344,"attrs":345},"link",{"href":346,"uuid":347,"anchor":59,"target":348,"linktype":14},"\u002Fhelp\u002Farticles\u002Fset-up-a-custom-tax-endpoint","6552c60a-9de0-4e28-9e82-16a4732c3fbb","_self",{"text":350,"type":333},".",{"type":327,"attrs":352,"content":353},{"level":329,"textAlign":59},[354],{"text":355,"type":333},"Events",{"type":335,"attrs":357,"content":358},{"textAlign":59},[359,361,366],{"text":360,"type":333},"Each request includes a ",{"text":362,"type":333,"marks":363},"foxy-webhook-event",[364],{"type":365},"code",{"text":367,"type":333}," header identifying the event:",{"type":369,"content":370},"table",[371,392,413,433,453,473],{"type":372,"content":373},"tableRow",[374,384],{"type":375,"attrs":376,"content":378},"tableHeader",{"colspan":377,"rowspan":377,"colwidth":59},1,[379],{"type":335,"attrs":380,"content":381},{"textAlign":59},[382],{"text":383,"type":333},"Event",{"type":375,"attrs":385,"content":386},{"colspan":377,"rowspan":377,"colwidth":59},[387],{"type":335,"attrs":388,"content":389},{"textAlign":59},[390],{"text":391,"type":333},"When it is sent",{"type":372,"content":393},[394,405],{"type":395,"attrs":396,"content":397},"tableCell",{"colspan":377,"rowspan":377,"colwidth":59,"backgroundColor":59},[398],{"type":335,"attrs":399,"content":400},{"textAlign":59},[401],{"text":402,"type":333,"marks":403},"tax\u002Fcalculate",[404],{"type":365},{"type":395,"attrs":406,"content":407},{"colspan":377,"rowspan":377,"colwidth":59,"backgroundColor":59},[408],{"type":335,"attrs":409,"content":410},{"textAlign":59},[411],{"text":412,"type":333},"For cart resources. Mirrors the custom shipping endpoint, which mirrors the API cart resource.",{"type":372,"content":414},[415,425],{"type":395,"attrs":416,"content":417},{"colspan":377,"rowspan":377,"colwidth":59,"backgroundColor":59},[418],{"type":335,"attrs":419,"content":420},{"textAlign":59},[421],{"text":422,"type":333,"marks":423},"tax\u002Freport",[424],{"type":365},{"type":395,"attrs":426,"content":427},{"colspan":377,"rowspan":377,"colwidth":59,"backgroundColor":59},[428],{"type":335,"attrs":429,"content":430},{"textAlign":59},[431],{"text":432,"type":333},"When the transaction completes. Body mirrors a zoomed transaction API resource.",{"type":372,"content":434},[435,445],{"type":395,"attrs":436,"content":437},{"colspan":377,"rowspan":377,"colwidth":59,"backgroundColor":59},[438],{"type":335,"attrs":439,"content":440},{"textAlign":59},[441],{"text":442,"type":333,"marks":443},"tax\u002Frefund",[444],{"type":365},{"type":395,"attrs":446,"content":447},{"colspan":377,"rowspan":377,"colwidth":59,"backgroundColor":59},[448],{"type":335,"attrs":449,"content":450},{"textAlign":59},[451],{"text":452,"type":333},"When a full refund is issued.",{"type":372,"content":454},[455,465],{"type":395,"attrs":456,"content":457},{"colspan":377,"rowspan":377,"colwidth":59,"backgroundColor":59},[458],{"type":335,"attrs":459,"content":460},{"textAlign":59},[461],{"text":462,"type":333,"marks":463},"tax\u002Fvoid",[464],{"type":365},{"type":395,"attrs":466,"content":467},{"colspan":377,"rowspan":377,"colwidth":59,"backgroundColor":59},[468],{"type":335,"attrs":469,"content":470},{"textAlign":59},[471],{"text":472,"type":333},"When a payment is voided. May need different handling for accounting or reporting.",{"type":372,"content":474},[475,485],{"type":395,"attrs":476,"content":477},{"colspan":377,"rowspan":377,"colwidth":59,"backgroundColor":59},[478],{"type":335,"attrs":479,"content":480},{"textAlign":59},[481],{"text":482,"type":333,"marks":483},"tax\u002Fupdate",[484],{"type":365},{"type":395,"attrs":486,"content":487},{"colspan":377,"rowspan":377,"colwidth":59,"backgroundColor":59},[488],{"type":335,"attrs":489,"content":490},{"textAlign":59},[491],{"text":492,"type":333},"When a partial refund is issued.",{"type":335,"attrs":494,"content":495},{"textAlign":59},[496],{"text":497,"type":333},"A separate header indicates the trigger:",{"type":369,"content":499},[500,518],{"type":372,"content":501},[502,510],{"type":375,"attrs":503,"content":504},{"colspan":377,"rowspan":377,"colwidth":59},[505],{"type":335,"attrs":506,"content":507},{"textAlign":59},[508],{"text":509,"type":333},"Trigger",{"type":375,"attrs":511,"content":512},{"colspan":377,"rowspan":377,"colwidth":59},[513],{"type":335,"attrs":514,"content":515},{"textAlign":59},[516],{"text":517,"type":333},"Meaning",{"type":372,"content":519},[520,530],{"type":395,"attrs":521,"content":522},{"colspan":377,"rowspan":377,"colwidth":59,"backgroundColor":59},[523],{"type":335,"attrs":524,"content":525},{"textAlign":59},[526],{"text":527,"type":333,"marks":528},"checkout\u002Fsubmit",[529],{"type":365},{"type":395,"attrs":531,"content":532},{"colspan":377,"rowspan":377,"colwidth":59,"backgroundColor":59},[533],{"type":335,"attrs":534,"content":535},{"textAlign":59},[536,538,541],{"text":537,"type":333},"Accompanies a ",{"text":402,"type":333,"marks":539},[540],{"type":365},{"text":542,"type":333}," event, present only when the customer has clicked submit. Not sent on cart changes or address updates; it fires right before the pre-payment webhook.",{"type":327,"attrs":544,"content":545},{"level":329,"textAlign":59},[546],{"text":547,"type":333},"Response format",{"type":369,"content":549},[550,568,598,627,647,667,687,707,733,758],{"type":372,"content":551},[552,560],{"type":375,"attrs":553,"content":554},{"colspan":377,"rowspan":377,"colwidth":59},[555],{"type":335,"attrs":556,"content":557},{"textAlign":59},[558],{"text":559,"type":333},"Attribute",{"type":375,"attrs":561,"content":562},{"colspan":377,"rowspan":377,"colwidth":59},[563],{"type":335,"attrs":564,"content":565},{"textAlign":59},[566],{"text":567,"type":333},"Description",{"type":372,"content":569},[570,580],{"type":395,"attrs":571,"content":572},{"colspan":377,"rowspan":377,"colwidth":59,"backgroundColor":59},[573],{"type":335,"attrs":574,"content":575},{"textAlign":59},[576],{"text":577,"type":333,"marks":578},"ok",[579],{"type":365},{"type":395,"attrs":581,"content":582},{"colspan":377,"rowspan":377,"colwidth":59,"backgroundColor":59},[583],{"type":335,"attrs":584,"content":585},{"textAlign":59},[586,590,592,596],{"text":587,"type":333,"marks":588},"true",[589],{"type":365},{"text":591,"type":333}," if the tax was calculated normally, ",{"text":593,"type":333,"marks":594},"false",[595],{"type":365},{"text":597,"type":333}," if there was an error.",{"type":372,"content":599},[600,610],{"type":395,"attrs":601,"content":602},{"colspan":377,"rowspan":377,"colwidth":59,"backgroundColor":59},[603],{"type":335,"attrs":604,"content":605},{"textAlign":59},[606],{"text":607,"type":333,"marks":608},"details",[609],{"type":365},{"type":395,"attrs":611,"content":612},{"colspan":377,"rowspan":377,"colwidth":59,"backgroundColor":59},[613],{"type":335,"attrs":614,"content":615},{"textAlign":59},[616,618,621,623,626],{"text":617,"type":333},"Error details, if any. Shown when ",{"text":577,"type":333,"marks":619},[620],{"type":365},{"text":622,"type":333}," is ",{"text":593,"type":333,"marks":624},[625],{"type":365},{"text":350,"type":333},{"type":372,"content":628},[629,639],{"type":395,"attrs":630,"content":631},{"colspan":377,"rowspan":377,"colwidth":59,"backgroundColor":59},[632],{"type":335,"attrs":633,"content":634},{"textAlign":59},[635],{"text":636,"type":333,"marks":637},"name",[638],{"type":365},{"type":395,"attrs":640,"content":641},{"colspan":377,"rowspan":377,"colwidth":59,"backgroundColor":59},[642],{"type":335,"attrs":643,"content":644},{"textAlign":59},[645],{"text":646,"type":333},"The tax name shown on the cart and checkout.",{"type":372,"content":648},[649,659],{"type":395,"attrs":650,"content":651},{"colspan":377,"rowspan":377,"colwidth":59,"backgroundColor":59},[652],{"type":335,"attrs":653,"content":654},{"textAlign":59},[655],{"text":656,"type":333,"marks":657},"expand_taxes",[658],{"type":365},{"type":395,"attrs":660,"content":661},{"colspan":377,"rowspan":377,"colwidth":59,"backgroundColor":59},[662],{"type":335,"attrs":663,"content":664},{"textAlign":59},[665],{"text":666,"type":333},"Array of the individual taxes that make up the total (at least one item). Shown individually on the receipt and in the admin.",{"type":372,"content":668},[669,679],{"type":395,"attrs":670,"content":671},{"colspan":377,"rowspan":377,"colwidth":59,"backgroundColor":59},[672],{"type":335,"attrs":673,"content":674},{"textAlign":59},[675],{"text":676,"type":333,"marks":677},"expand_taxes[].name",[678],{"type":365},{"type":395,"attrs":680,"content":681},{"colspan":377,"rowspan":377,"colwidth":59,"backgroundColor":59},[682],{"type":335,"attrs":683,"content":684},{"textAlign":59},[685],{"text":686,"type":333},"Name of the individual tax.",{"type":372,"content":688},[689,699],{"type":395,"attrs":690,"content":691},{"colspan":377,"rowspan":377,"colwidth":59,"backgroundColor":59},[692],{"type":335,"attrs":693,"content":694},{"textAlign":59},[695],{"text":696,"type":333,"marks":697},"expand_taxes[].amount",[698],{"type":365},{"type":395,"attrs":700,"content":701},{"colspan":377,"rowspan":377,"colwidth":59,"backgroundColor":59},[702],{"type":335,"attrs":703,"content":704},{"textAlign":59},[705],{"text":706,"type":333},"Amount for the individual tax.",{"type":372,"content":708},[709,719],{"type":395,"attrs":710,"content":711},{"colspan":377,"rowspan":377,"colwidth":59,"backgroundColor":59},[712],{"type":335,"attrs":713,"content":714},{"textAlign":59},[715],{"text":716,"type":333,"marks":717},"expand_taxes[].rate",[718],{"type":365},{"type":395,"attrs":720,"content":721},{"colspan":377,"rowspan":377,"colwidth":59,"backgroundColor":59},[722],{"type":335,"attrs":723,"content":724},{"textAlign":59},[725,727,731],{"text":726,"type":333},"Rate for the individual tax, as a decimal (5% is ",{"text":728,"type":333,"marks":729},"0.05",[730],{"type":365},{"text":732,"type":333},").",{"type":372,"content":734},[735,745],{"type":395,"attrs":736,"content":737},{"colspan":377,"rowspan":377,"colwidth":59,"backgroundColor":59},[738],{"type":335,"attrs":739,"content":740},{"textAlign":59},[741],{"text":742,"type":333,"marks":743},"total_amount",[744],{"type":365},{"type":395,"attrs":746,"content":747},{"colspan":377,"rowspan":377,"colwidth":59,"backgroundColor":59},[748],{"type":335,"attrs":749,"content":750},{"textAlign":59},[751,753,756],{"text":752,"type":333},"Total tax amount added to the order total. Should equal the sum of the ",{"text":656,"type":333,"marks":754},[755],{"type":365},{"text":757,"type":333}," amounts.",{"type":372,"content":759},[760,770],{"type":395,"attrs":761,"content":762},{"colspan":377,"rowspan":377,"colwidth":59,"backgroundColor":59},[763],{"type":335,"attrs":764,"content":765},{"textAlign":59},[766],{"text":767,"type":333,"marks":768},"total_rate",[769],{"type":365},{"type":395,"attrs":771,"content":772},{"colspan":377,"rowspan":377,"colwidth":59,"backgroundColor":59},[773],{"type":335,"attrs":774,"content":775},{"textAlign":59},[776,778,781],{"text":777,"type":333},"Total combined rate, as a decimal, shown on the cart and checkout. Should equal the sum of the ",{"text":656,"type":333,"marks":779},[780],{"type":365},{"text":782,"type":333}," rates.",{"type":327,"attrs":784,"content":785},{"level":329,"textAlign":59},[786],{"text":787,"type":333},"Example responses",{"type":335,"attrs":789,"content":790},{"textAlign":59},[791],{"text":792,"type":333},"Successful response with taxes:",{"type":794,"attrs":795,"content":796},"code_block",{"class":59},[797],{"text":798,"type":333},"{\n  \"ok\": true,\n  \"details\": \"\",\n  \"name\": \"Custom Tax\",\n  \"expand_taxes\": [\n    { \"name\": \"Super Tax\", \"amount\": 5.00, \"rate\": 0.05 },\n    { \"name\": \"Mega Tax\", \"amount\": 2.00, \"rate\": 0.02 }\n  ],\n  \"total_amount\": 7.00,\n  \"total_rate\": 0.07\n}",{"type":335,"attrs":800,"content":801},{"textAlign":59},[802],{"text":803,"type":333},"Successful response with no taxes to display:",{"type":794,"attrs":805,"content":806},{"class":59},[807],{"text":808,"type":333},"{\n  \"ok\": true,\n  \"details\": \"\",\n  \"name\": \"\",\n  \"expand_taxes\": [],\n  \"total_amount\": 0,\n  \"total_rate\": 0\n}",{"type":335,"attrs":810,"content":811},{"textAlign":59},[812],{"text":813,"type":333},"Error response (prevents checkout). If Foxy does not receive a valid response, it shows a default error and also prevents checkout:",{"type":794,"attrs":815,"content":816},{"class":59},[817],{"text":818,"type":333},"{\n  \"ok\": false,\n  \"details\": \"Your error message\"\n}",{"type":335,"attrs":820,"content":821},{"textAlign":59},[822,824,828],{"text":823,"type":333},"Display a tax without a percentage rate by omitting ",{"text":825,"type":333,"marks":826},"rate",[827],{"type":365},{"text":829,"type":333},":",{"type":794,"attrs":831,"content":832},{"class":59},[833],{"text":834,"type":333},"{\n  \"ok\": true,\n  \"details\": \"\",\n  \"name\": \"Custom Tax\",\n  \"expand_taxes\": [\n    { \"name\": \"Tax\", \"amount\": 5.00 }\n  ],\n  \"total_amount\": 5.00\n}",{"type":335,"attrs":836,"content":837},{"textAlign":59},[838,840,844],{"text":839,"type":333},"Display a 0% tax by setting the rate to ",{"text":841,"type":333,"marks":842},"0",[843],{"type":365},{"text":829,"type":333},{"type":794,"attrs":846,"content":847},{"class":59},[848],{"text":849,"type":333},"{\n  \"ok\": true,\n  \"details\": \"\",\n  \"name\": \"Zero Amount\",\n  \"expand_taxes\": [\n    { \"name\": \"Tax\", \"rate\": 0, \"amount\": 0 }\n  ],\n  \"total_amount\": 0,\n  \"total_rate\": 0\n}",{"id":59,"alt":59,"name":13,"focus":59,"title":59,"source":59,"filename":13,"copyright":59,"fieldtype":81,"meta_data":851},{},"Reference for the Foxy custom tax endpoint, including webhook events, response format, and example payloads.","d8395b12-d86d-4c10-b9a0-1f2d3b100f1a",[],"custom-tax-endpoint-reference","help\u002Farticles\u002Fcustom-tax-endpoint-reference",-3020,[],2659,"c6ca661a-cd1f-4e0a-bb89-5ef5491a2186","2026-07-06T20:06:03.854Z",[],{"html":864,"sections":865,"segments":875},"\u003Csection id=\"overview\" data-title=\"Overview\" data-title-node=\"H2\">\u003Chr class=\"my-8\" style=\"margin-left: -48px; margin-right: -40vw\">\u003Ch2 data-anchor-id=\"overview\">Overview\u003C\u002Fh2>\u003Cp>This is a lookup reference for the custom tax endpoint. For setup, see \u003Ca href=\"\u002Fhelp\u002Farticles\u002Fset-up-a-custom-tax-endpoint\" target=\"_self\">Set up a custom tax endpoint\u003C\u002Fa>.\u003C\u002Fp>\u003C\u002Fsection>\u003Csection id=\"events\" data-title=\"Events\" data-title-node=\"H2\">\u003Chr class=\"my-8\" style=\"margin-left: -48px; margin-right: -40vw\">\u003Ch2 data-anchor-id=\"events\">Events\u003C\u002Fh2>\u003Cp>Each request includes a \u003Ccode class=\"badge bg-soft-danger text-danger\">foxy-webhook-event\u003C\u002Fcode> header identifying the event:\u003C\u002Fp>\u003Cdiv class=\"table-responsive w-100\">\u003Ctable class=\"table table-lg table-bordered my-5\">\u003Cthead class=\"thead-light\">\u003Ctr>\u003Cth>\u003Cp>Event\u003C\u002Fp>\u003C\u002Fth>\u003Cth>\u003Cp>When it is sent\u003C\u002Fp>\u003C\u002Fth>\u003C\u002Ftr>\u003C\u002Fthead>\u003Ctbody>\u003Ctr>\u003Ctd>\u003Cp>\u003Ccode class=\"badge bg-soft-danger text-danger\">tax\u002Fcalculate\u003C\u002Fcode>\u003C\u002Fp>\u003C\u002Ftd>\u003Ctd>\u003Cp>For cart resources. Mirrors the custom shipping endpoint, which mirrors the API cart resource.\u003C\u002Fp>\u003C\u002Ftd>\u003C\u002Ftr>\u003Ctr>\u003Ctd>\u003Cp>\u003Ccode class=\"badge bg-soft-danger text-danger\">tax\u002Freport\u003C\u002Fcode>\u003C\u002Fp>\u003C\u002Ftd>\u003Ctd>\u003Cp>When the transaction completes. Body mirrors a zoomed transaction API resource.\u003C\u002Fp>\u003C\u002Ftd>\u003C\u002Ftr>\u003Ctr>\u003Ctd>\u003Cp>\u003Ccode class=\"badge bg-soft-danger text-danger\">tax\u002Frefund\u003C\u002Fcode>\u003C\u002Fp>\u003C\u002Ftd>\u003Ctd>\u003Cp>When a full refund is issued.\u003C\u002Fp>\u003C\u002Ftd>\u003C\u002Ftr>\u003Ctr>\u003Ctd>\u003Cp>\u003Ccode class=\"badge bg-soft-danger text-danger\">tax\u002Fvoid\u003C\u002Fcode>\u003C\u002Fp>\u003C\u002Ftd>\u003Ctd>\u003Cp>When a payment is voided. May need different handling for accounting or reporting.\u003C\u002Fp>\u003C\u002Ftd>\u003C\u002Ftr>\u003Ctr>\u003Ctd>\u003Cp>\u003Ccode class=\"badge bg-soft-danger text-danger\">tax\u002Fupdate\u003C\u002Fcode>\u003C\u002Fp>\u003C\u002Ftd>\u003Ctd>\u003Cp>When a partial refund is issued.\u003C\u002Fp>\u003C\u002Ftd>\u003C\u002Ftr>\u003C\u002Ftbody>\u003C\u002Ftable>\u003C\u002Fdiv>\u003Cp>A separate header indicates the trigger:\u003C\u002Fp>\u003Cdiv class=\"table-responsive w-100\">\u003Ctable class=\"table table-lg table-bordered my-5\">\u003Cthead class=\"thead-light\">\u003Ctr>\u003Cth>\u003Cp>Trigger\u003C\u002Fp>\u003C\u002Fth>\u003Cth>\u003Cp>Meaning\u003C\u002Fp>\u003C\u002Fth>\u003C\u002Ftr>\u003C\u002Fthead>\u003Ctbody>\u003Ctr>\u003Ctd>\u003Cp>\u003Ccode class=\"badge bg-soft-danger text-danger\">checkout\u002Fsubmit\u003C\u002Fcode>\u003C\u002Fp>\u003C\u002Ftd>\u003Ctd>\u003Cp>Accompanies a \u003Ccode class=\"badge bg-soft-danger text-danger\">tax\u002Fcalculate\u003C\u002Fcode> event, present only when the customer has clicked submit. Not sent on cart changes or address updates; it fires right before the pre-payment webhook.\u003C\u002Fp>\u003C\u002Ftd>\u003C\u002Ftr>\u003C\u002Ftbody>\u003C\u002Ftable>\u003C\u002Fdiv>\u003C\u002Fsection>\u003Csection id=\"response-format\" data-title=\"Response format\" data-title-node=\"H2\">\u003Chr class=\"my-8\" style=\"margin-left: -48px; margin-right: -40vw\">\u003Ch2 data-anchor-id=\"response-format\">Response format\u003C\u002Fh2>\u003Cdiv class=\"table-responsive w-100\">\u003Ctable class=\"table table-lg table-bordered my-5\">\u003Cthead class=\"thead-light\">\u003Ctr>\u003Cth>\u003Cp>Attribute\u003C\u002Fp>\u003C\u002Fth>\u003Cth>\u003Cp>Description\u003C\u002Fp>\u003C\u002Fth>\u003C\u002Ftr>\u003C\u002Fthead>\u003Ctbody>\u003Ctr>\u003Ctd>\u003Cp>\u003Ccode class=\"badge bg-soft-danger text-danger\">ok\u003C\u002Fcode>\u003C\u002Fp>\u003C\u002Ftd>\u003Ctd>\u003Cp>\u003Ccode class=\"badge bg-soft-danger text-danger\">true\u003C\u002Fcode> if the tax was calculated normally, \u003Ccode class=\"badge bg-soft-danger text-danger\">false\u003C\u002Fcode> if there was an error.\u003C\u002Fp>\u003C\u002Ftd>\u003C\u002Ftr>\u003Ctr>\u003Ctd>\u003Cp>\u003Ccode class=\"badge bg-soft-danger text-danger\">details\u003C\u002Fcode>\u003C\u002Fp>\u003C\u002Ftd>\u003Ctd>\u003Cp>Error details, if any. Shown when \u003Ccode class=\"badge bg-soft-danger text-danger\">ok\u003C\u002Fcode> is \u003Ccode class=\"badge bg-soft-danger text-danger\">false\u003C\u002Fcode>.\u003C\u002Fp>\u003C\u002Ftd>\u003C\u002Ftr>\u003Ctr>\u003Ctd>\u003Cp>\u003Ccode class=\"badge bg-soft-danger text-danger\">name\u003C\u002Fcode>\u003C\u002Fp>\u003C\u002Ftd>\u003Ctd>\u003Cp>The tax name shown on the cart and checkout.\u003C\u002Fp>\u003C\u002Ftd>\u003C\u002Ftr>\u003Ctr>\u003Ctd>\u003Cp>\u003Ccode class=\"badge bg-soft-danger text-danger\">expand_taxes\u003C\u002Fcode>\u003C\u002Fp>\u003C\u002Ftd>\u003Ctd>\u003Cp>Array of the individual taxes that make up the total (at least one item). Shown individually on the receipt and in the admin.\u003C\u002Fp>\u003C\u002Ftd>\u003C\u002Ftr>\u003Ctr>\u003Ctd>\u003Cp>\u003Ccode class=\"badge bg-soft-danger text-danger\">expand_taxes[].name\u003C\u002Fcode>\u003C\u002Fp>\u003C\u002Ftd>\u003Ctd>\u003Cp>Name of the individual tax.\u003C\u002Fp>\u003C\u002Ftd>\u003C\u002Ftr>\u003Ctr>\u003Ctd>\u003Cp>\u003Ccode class=\"badge bg-soft-danger text-danger\">expand_taxes[].amount\u003C\u002Fcode>\u003C\u002Fp>\u003C\u002Ftd>\u003Ctd>\u003Cp>Amount for the individual tax.\u003C\u002Fp>\u003C\u002Ftd>\u003C\u002Ftr>\u003Ctr>\u003Ctd>\u003Cp>\u003Ccode class=\"badge bg-soft-danger text-danger\">expand_taxes[].rate\u003C\u002Fcode>\u003C\u002Fp>\u003C\u002Ftd>\u003Ctd>\u003Cp>Rate for the individual tax, as a decimal (5% is \u003Ccode class=\"badge bg-soft-danger text-danger\">0.05\u003C\u002Fcode>).\u003C\u002Fp>\u003C\u002Ftd>\u003C\u002Ftr>\u003Ctr>\u003Ctd>\u003Cp>\u003Ccode class=\"badge bg-soft-danger text-danger\">total_amount\u003C\u002Fcode>\u003C\u002Fp>\u003C\u002Ftd>\u003Ctd>\u003Cp>Total tax amount added to the order total. Should equal the sum of the \u003Ccode class=\"badge bg-soft-danger text-danger\">expand_taxes\u003C\u002Fcode> amounts.\u003C\u002Fp>\u003C\u002Ftd>\u003C\u002Ftr>\u003Ctr>\u003Ctd>\u003Cp>\u003Ccode class=\"badge bg-soft-danger text-danger\">total_rate\u003C\u002Fcode>\u003C\u002Fp>\u003C\u002Ftd>\u003Ctd>\u003Cp>Total combined rate, as a decimal, shown on the cart and checkout. Should equal the sum of the \u003Ccode class=\"badge bg-soft-danger text-danger\">expand_taxes\u003C\u002Fcode> rates.\u003C\u002Fp>\u003C\u002Ftd>\u003C\u002Ftr>\u003C\u002Ftbody>\u003C\u002Ftable>\u003C\u002Fdiv>\u003C\u002Fsection>\u003Csection id=\"example-responses\" data-title=\"Example responses\" data-title-node=\"H2\">\u003Chr class=\"my-8\" style=\"margin-left: -48px; margin-right: -40vw\">\u003Ch2 data-anchor-id=\"example-responses\">Example responses\u003C\u002Fh2>\u003Cp>Successful response with taxes:\u003C\u002Fp>\u003Cdiv class=\"position-relative w-100 overflow-hidden rounded-2\" data-code-block>\u003Cdiv class=\"d-flex justify-content-end border-bottom\" style=\"background:#2b2c3b;\">\u003Cbutton type=\"button\" class=\"btn btn-link btn-sm text-light\" title=\"Copy\" data-code-button>\u003Cspan data-code-default style=\"\">\u003Ci class=\"fal fa-copy me-2\">\u003C\u002Fi> Copy \u003C\u002Fspan>\u003Cspan class=\"text-success\" data-code-success style=\"display:none;\">\u003Ci class=\"fal fa-check ms-2\">\u003C\u002Fi> Copied \u003C\u002Fspan>\u003C\u002Fbutton>\u003C\u002Fdiv>\u003Cdiv class=\"small\">\u003Cpre class=\"hljs p-2\" data-code-content>{\n  "ok": true,\n  "details": "",\n  "name": "Custom Tax",\n  "expand_taxes": [\n    { "name": "Super Tax", "amount": 5.00, "rate": 0.05 },\n    { "name": "Mega Tax", "amount": 2.00, "rate": 0.02 }\n  ],\n  "total_amount": 7.00,\n  "total_rate": 0.07\n}\u003C\u002Fpre>\u003C\u002Fdiv>\u003C\u002Fdiv>\u003Cp>Successful response with no taxes to display:\u003C\u002Fp>\u003Cdiv class=\"position-relative w-100 overflow-hidden rounded-2\" data-code-block>\u003Cdiv class=\"d-flex justify-content-end border-bottom\" style=\"background:#2b2c3b;\">\u003Cbutton type=\"button\" class=\"btn btn-link btn-sm text-light\" title=\"Copy\" data-code-button>\u003Cspan data-code-default style=\"\">\u003Ci class=\"fal fa-copy me-2\">\u003C\u002Fi> Copy \u003C\u002Fspan>\u003Cspan class=\"text-success\" data-code-success style=\"display:none;\">\u003Ci class=\"fal fa-check ms-2\">\u003C\u002Fi> Copied \u003C\u002Fspan>\u003C\u002Fbutton>\u003C\u002Fdiv>\u003Cdiv class=\"small\">\u003Cpre class=\"hljs p-2\" data-code-content>{\n  "ok": true,\n  "details": "",\n  "name": "",\n  "expand_taxes": [],\n  "total_amount": 0,\n  "total_rate": 0\n}\u003C\u002Fpre>\u003C\u002Fdiv>\u003C\u002Fdiv>\u003Cp>Error response (prevents checkout). If Foxy does not receive a valid response, it shows a default error and also prevents checkout:\u003C\u002Fp>\u003Cdiv class=\"position-relative w-100 overflow-hidden rounded-2\" data-code-block>\u003Cdiv class=\"d-flex justify-content-end border-bottom\" style=\"background:#2b2c3b;\">\u003Cbutton type=\"button\" class=\"btn btn-link btn-sm text-light\" title=\"Copy\" data-code-button>\u003Cspan data-code-default style=\"\">\u003Ci class=\"fal fa-copy me-2\">\u003C\u002Fi> Copy \u003C\u002Fspan>\u003Cspan class=\"text-success\" data-code-success style=\"display:none;\">\u003Ci class=\"fal fa-check ms-2\">\u003C\u002Fi> Copied \u003C\u002Fspan>\u003C\u002Fbutton>\u003C\u002Fdiv>\u003Cdiv class=\"small\">\u003Cpre class=\"hljs p-2\" data-code-content>{\n  "ok": false,\n  "details": "Your error message"\n}\u003C\u002Fpre>\u003C\u002Fdiv>\u003C\u002Fdiv>\u003Cp>Display a tax without a percentage rate by omitting \u003Ccode class=\"badge bg-soft-danger text-danger\">rate\u003C\u002Fcode>:\u003C\u002Fp>\u003Cdiv class=\"position-relative w-100 overflow-hidden rounded-2\" data-code-block>\u003Cdiv class=\"d-flex justify-content-end border-bottom\" style=\"background:#2b2c3b;\">\u003Cbutton type=\"button\" class=\"btn btn-link btn-sm text-light\" title=\"Copy\" data-code-button>\u003Cspan data-code-default style=\"\">\u003Ci class=\"fal fa-copy me-2\">\u003C\u002Fi> Copy \u003C\u002Fspan>\u003Cspan class=\"text-success\" data-code-success style=\"display:none;\">\u003Ci class=\"fal fa-check ms-2\">\u003C\u002Fi> Copied \u003C\u002Fspan>\u003C\u002Fbutton>\u003C\u002Fdiv>\u003Cdiv class=\"small\">\u003Cpre class=\"hljs p-2\" data-code-content>{\n  "ok": true,\n  "details": "",\n  "name": "Custom Tax",\n  "expand_taxes": [\n    { "name": "Tax", "amount": 5.00 }\n  ],\n  "total_amount": 5.00\n}\u003C\u002Fpre>\u003C\u002Fdiv>\u003C\u002Fdiv>\u003Cp>Display a 0% tax by setting the rate to \u003Ccode class=\"badge bg-soft-danger text-danger\">0\u003C\u002Fcode>:\u003C\u002Fp>\u003Cdiv class=\"position-relative w-100 overflow-hidden rounded-2\" data-code-block>\u003Cdiv class=\"d-flex justify-content-end border-bottom\" style=\"background:#2b2c3b;\">\u003Cbutton type=\"button\" class=\"btn btn-link btn-sm text-light\" title=\"Copy\" data-code-button>\u003Cspan data-code-default style=\"\">\u003Ci class=\"fal fa-copy me-2\">\u003C\u002Fi> Copy \u003C\u002Fspan>\u003Cspan class=\"text-success\" data-code-success style=\"display:none;\">\u003Ci class=\"fal fa-check ms-2\">\u003C\u002Fi> Copied \u003C\u002Fspan>\u003C\u002Fbutton>\u003C\u002Fdiv>\u003Cdiv class=\"small\">\u003Cpre class=\"hljs p-2\" data-code-content>{\n  "ok": true,\n  "details": "",\n  "name": "Zero Amount",\n  "expand_taxes": [\n    { "name": "Tax", "rate": 0, "amount": 0 }\n  ],\n  "total_amount": 0,\n  "total_rate": 0\n}\u003C\u002Fpre>\u003C\u002Fdiv>\u003C\u002Fdiv>\u003C\u002Fsection>",[866,869,871,873],{"id":867,"title":332,"level":868},"overview","H2",{"id":870,"title":355,"level":868},"events",{"id":872,"title":547,"level":868},"response-format",{"id":874,"title":787,"level":868},"example-responses",[876],{"type":877,"content":878},"html","\u003Ch2>Overview\u003C\u002Fh2>\u003Cp>This is a lookup reference for the custom tax endpoint. For setup, see \u003Ca href=\"\u002Fhelp\u002Farticles\u002Fset-up-a-custom-tax-endpoint\" target=\"_self\">Set up a custom tax endpoint\u003C\u002Fa>.\u003C\u002Fp>\u003Ch2>Events\u003C\u002Fh2>\u003Cp>Each request includes a \u003Ccode class=\"badge bg-soft-danger text-danger\">foxy-webhook-event\u003C\u002Fcode> header identifying the event:\u003C\u002Fp>\u003Cdiv class=\"table-responsive w-100\">\u003Ctable class=\"table table-lg table-bordered my-5\">\u003Cthead>\u003Ctr>\u003Cth>\u003Cp>Event\u003C\u002Fp>\u003C\u002Fth>\u003Cth>\u003Cp>When it is sent\u003C\u002Fp>\u003C\u002Fth>\u003C\u002Ftr>\u003C\u002Fthead>\u003Ctbody>\u003Ctr>\u003Ctd>\u003Cp>\u003Ccode class=\"badge bg-soft-danger text-danger\">tax\u002Fcalculate\u003C\u002Fcode>\u003C\u002Fp>\u003C\u002Ftd>\u003Ctd>\u003Cp>For cart resources. Mirrors the custom shipping endpoint, which mirrors the API cart resource.\u003C\u002Fp>\u003C\u002Ftd>\u003C\u002Ftr>\u003Ctr>\u003Ctd>\u003Cp>\u003Ccode class=\"badge bg-soft-danger text-danger\">tax\u002Freport\u003C\u002Fcode>\u003C\u002Fp>\u003C\u002Ftd>\u003Ctd>\u003Cp>When the transaction completes. Body mirrors a zoomed transaction API resource.\u003C\u002Fp>\u003C\u002Ftd>\u003C\u002Ftr>\u003Ctr>\u003Ctd>\u003Cp>\u003Ccode class=\"badge bg-soft-danger text-danger\">tax\u002Frefund\u003C\u002Fcode>\u003C\u002Fp>\u003C\u002Ftd>\u003Ctd>\u003Cp>When a full refund is issued.\u003C\u002Fp>\u003C\u002Ftd>\u003C\u002Ftr>\u003Ctr>\u003Ctd>\u003Cp>\u003Ccode class=\"badge bg-soft-danger text-danger\">tax\u002Fvoid\u003C\u002Fcode>\u003C\u002Fp>\u003C\u002Ftd>\u003Ctd>\u003Cp>When a payment is voided. May need different handling for accounting or reporting.\u003C\u002Fp>\u003C\u002Ftd>\u003C\u002Ftr>\u003Ctr>\u003Ctd>\u003Cp>\u003Ccode class=\"badge bg-soft-danger text-danger\">tax\u002Fupdate\u003C\u002Fcode>\u003C\u002Fp>\u003C\u002Ftd>\u003Ctd>\u003Cp>When a partial refund is issued.\u003C\u002Fp>\u003C\u002Ftd>\u003C\u002Ftr>\u003C\u002Ftbody>\u003C\u002Ftable>\u003C\u002Fdiv>\u003Cp>A separate header indicates the trigger:\u003C\u002Fp>\u003Cdiv class=\"table-responsive w-100\">\u003Ctable class=\"table table-lg table-bordered my-5\">\u003Cthead>\u003Ctr>\u003Cth>\u003Cp>Trigger\u003C\u002Fp>\u003C\u002Fth>\u003Cth>\u003Cp>Meaning\u003C\u002Fp>\u003C\u002Fth>\u003C\u002Ftr>\u003C\u002Fthead>\u003Ctbody>\u003Ctr>\u003Ctd>\u003Cp>\u003Ccode class=\"badge bg-soft-danger text-danger\">checkout\u002Fsubmit\u003C\u002Fcode>\u003C\u002Fp>\u003C\u002Ftd>\u003Ctd>\u003Cp>Accompanies a \u003Ccode class=\"badge bg-soft-danger text-danger\">tax\u002Fcalculate\u003C\u002Fcode> event, present only when the customer has clicked submit. Not sent on cart changes or address updates; it fires right before the pre-payment webhook.\u003C\u002Fp>\u003C\u002Ftd>\u003C\u002Ftr>\u003C\u002Ftbody>\u003C\u002Ftable>\u003C\u002Fdiv>\u003Ch2>Response format\u003C\u002Fh2>\u003Cdiv class=\"table-responsive w-100\">\u003Ctable class=\"table table-lg table-bordered my-5\">\u003Cthead>\u003Ctr>\u003Cth>\u003Cp>Attribute\u003C\u002Fp>\u003C\u002Fth>\u003Cth>\u003Cp>Description\u003C\u002Fp>\u003C\u002Fth>\u003C\u002Ftr>\u003C\u002Fthead>\u003Ctbody>\u003Ctr>\u003Ctd>\u003Cp>\u003Ccode class=\"badge bg-soft-danger text-danger\">ok\u003C\u002Fcode>\u003C\u002Fp>\u003C\u002Ftd>\u003Ctd>\u003Cp>\u003Ccode class=\"badge bg-soft-danger text-danger\">true\u003C\u002Fcode> if the tax was calculated normally, \u003Ccode class=\"badge bg-soft-danger text-danger\">false\u003C\u002Fcode> if there was an error.\u003C\u002Fp>\u003C\u002Ftd>\u003C\u002Ftr>\u003Ctr>\u003Ctd>\u003Cp>\u003Ccode class=\"badge bg-soft-danger text-danger\">details\u003C\u002Fcode>\u003C\u002Fp>\u003C\u002Ftd>\u003Ctd>\u003Cp>Error details, if any. Shown when \u003Ccode class=\"badge bg-soft-danger text-danger\">ok\u003C\u002Fcode> is \u003Ccode class=\"badge bg-soft-danger text-danger\">false\u003C\u002Fcode>.\u003C\u002Fp>\u003C\u002Ftd>\u003C\u002Ftr>\u003Ctr>\u003Ctd>\u003Cp>\u003Ccode class=\"badge bg-soft-danger text-danger\">name\u003C\u002Fcode>\u003C\u002Fp>\u003C\u002Ftd>\u003Ctd>\u003Cp>The tax name shown on the cart and checkout.\u003C\u002Fp>\u003C\u002Ftd>\u003C\u002Ftr>\u003Ctr>\u003Ctd>\u003Cp>\u003Ccode class=\"badge bg-soft-danger text-danger\">expand_taxes\u003C\u002Fcode>\u003C\u002Fp>\u003C\u002Ftd>\u003Ctd>\u003Cp>Array of the individual taxes that make up the total (at least one item). Shown individually on the receipt and in the admin.\u003C\u002Fp>\u003C\u002Ftd>\u003C\u002Ftr>\u003Ctr>\u003Ctd>\u003Cp>\u003Ccode class=\"badge bg-soft-danger text-danger\">expand_taxes[].name\u003C\u002Fcode>\u003C\u002Fp>\u003C\u002Ftd>\u003Ctd>\u003Cp>Name of the individual tax.\u003C\u002Fp>\u003C\u002Ftd>\u003C\u002Ftr>\u003Ctr>\u003Ctd>\u003Cp>\u003Ccode class=\"badge bg-soft-danger text-danger\">expand_taxes[].amount\u003C\u002Fcode>\u003C\u002Fp>\u003C\u002Ftd>\u003Ctd>\u003Cp>Amount for the individual tax.\u003C\u002Fp>\u003C\u002Ftd>\u003C\u002Ftr>\u003Ctr>\u003Ctd>\u003Cp>\u003Ccode class=\"badge bg-soft-danger text-danger\">expand_taxes[].rate\u003C\u002Fcode>\u003C\u002Fp>\u003C\u002Ftd>\u003Ctd>\u003Cp>Rate for the individual tax, as a decimal (5% is \u003Ccode class=\"badge bg-soft-danger text-danger\">0.05\u003C\u002Fcode>).\u003C\u002Fp>\u003C\u002Ftd>\u003C\u002Ftr>\u003Ctr>\u003Ctd>\u003Cp>\u003Ccode class=\"badge bg-soft-danger text-danger\">total_amount\u003C\u002Fcode>\u003C\u002Fp>\u003C\u002Ftd>\u003Ctd>\u003Cp>Total tax amount added to the order total. Should equal the sum of the \u003Ccode class=\"badge bg-soft-danger text-danger\">expand_taxes\u003C\u002Fcode> amounts.\u003C\u002Fp>\u003C\u002Ftd>\u003C\u002Ftr>\u003Ctr>\u003Ctd>\u003Cp>\u003Ccode class=\"badge bg-soft-danger text-danger\">total_rate\u003C\u002Fcode>\u003C\u002Fp>\u003C\u002Ftd>\u003Ctd>\u003Cp>Total combined rate, as a decimal, shown on the cart and checkout. Should equal the sum of the \u003Ccode class=\"badge bg-soft-danger text-danger\">expand_taxes\u003C\u002Fcode> rates.\u003C\u002Fp>\u003C\u002Ftd>\u003C\u002Ftr>\u003C\u002Ftbody>\u003C\u002Ftable>\u003C\u002Fdiv>\u003Ch2>Example responses\u003C\u002Fh2>\u003Cp>Successful response with taxes:\u003C\u002Fp>\u003Cpre>\u003Ccode>{\n  "ok": true,\n  "details": "",\n  "name": "Custom Tax",\n  "expand_taxes": [\n    { "name": "Super Tax", "amount": 5.00, "rate": 0.05 },\n    { "name": "Mega Tax", "amount": 2.00, "rate": 0.02 }\n  ],\n  "total_amount": 7.00,\n  "total_rate": 0.07\n}\u003C\u002Fcode>\u003C\u002Fpre>\u003Cp>Successful response with no taxes to display:\u003C\u002Fp>\u003Cpre>\u003Ccode>{\n  "ok": true,\n  "details": "",\n  "name": "",\n  "expand_taxes": [],\n  "total_amount": 0,\n  "total_rate": 0\n}\u003C\u002Fcode>\u003C\u002Fpre>\u003Cp>Error response (prevents checkout). If Foxy does not receive a valid response, it shows a default error and also prevents checkout:\u003C\u002Fp>\u003Cpre>\u003Ccode>{\n  "ok": false,\n  "details": "Your error message"\n}\u003C\u002Fcode>\u003C\u002Fpre>\u003Cp>Display a tax without a percentage rate by omitting \u003Ccode class=\"badge bg-soft-danger text-danger\">rate\u003C\u002Fcode>:\u003C\u002Fp>\u003Cpre>\u003Ccode>{\n  "ok": true,\n  "details": "",\n  "name": "Custom Tax",\n  "expand_taxes": [\n    { "name": "Tax", "amount": 5.00 }\n  ],\n  "total_amount": 5.00\n}\u003C\u002Fcode>\u003C\u002Fpre>\u003Cp>Display a 0% tax by setting the rate to \u003Ccode class=\"badge bg-soft-danger text-danger\">0\u003C\u002Fcode>:\u003C\u002Fp>\u003Cpre>\u003Ccode>{\n  "ok": true,\n  "details": "",\n  "name": "Zero Amount",\n  "expand_taxes": [\n    { "name": "Tax", "rate": 0, "amount": 0 }\n  ],\n  "total_amount": 0,\n  "total_rate": 0\n}\u003C\u002Fcode>\u003C\u002Fpre>",{"name":880,"created_at":881,"published_at":882,"updated_at":883,"id":884,"uuid":47,"content":885,"slug":48,"full_slug":48,"sort_by_date":59,"position":1063,"tag_list":1064,"is_startpage":24,"parent_id":59,"meta_data":59,"group_id":1065,"first_published_at":1066,"release_id":59,"lang":65,"path":59,"alternates":1067,"default_full_slug":59,"translated_slugs":59},"Contact","2022-09-23T19:56:58.957Z","2025-05-08T18:24:40.382Z","2025-05-08T18:24:40.392Z",3138,{"seo":886,"_uid":889,"title":890,"action":891,"fields":892,"method":1039,"columns":1040,"subtitle":1054,"component":48,"button_text":1060,"submit_title":1061,"submit_subtitle":1062},{"_uid":887,"title":880,"plugin":888,"description":13},"24ff7574-3bcc-48d2-85b5-e529dfea1cc4","meta-fields","8f54f1da-9d8f-49b2-89e7-840e886491cb","We're here to help.","https:\u002F\u002Fusebasin.com\u002Ff\u002F029f48d65402",[893,897,901,1010,1013,1018,1033],{"_uid":894,"name":636,"type":333,"label":895,"options":13,"required":33,"component":896,"placeholder":13},"9a70b226-2036-4f90-a052-b3efa61c5896","Name","form___field",{"_uid":898,"name":899,"type":899,"label":900,"options":13,"required":33,"component":896,"placeholder":13},"86ba35be-ff43-4a28-8633-14052a8f6622","email","Email Address",{"_uid":902,"name":903,"type":904,"label":905,"options":906,"required":33,"component":896,"conditions":907,"placeholder":13},"3f827475-492c-4f97-aa1e-2386ac263b6c","topic","select","Topic","Presales, Support, Billing, Partnerships, Order Enquiry, Other",[908,964,974,981,989,997,1003],{"_uid":909,"equals":910,"fields":911,"component":963},"e21d97dd-e68e-4fa6-ba97-bc40f3041dde","Order Enquiry",[912],{"_uid":913,"body":914,"type":961,"title":13,"component":962},"b64992bc-6d53-48b8-b7a0-d81e5a062e50",{"type":324,"content":915},[916],{"type":335,"content":917},[918,920,927,929,931,932,937,939,944,952,954,959],{"text":919,"type":333},"We are ",{"text":921,"type":333,"marks":922},"Foxy.io",[923],{"type":344,"attrs":924},{"href":925,"uuid":59,"anchor":59,"custom":926,"target":59,"linktype":31},"http:\u002F\u002FFoxy.io",{},{"text":928,"type":333},", an ecommerce platform powering ecommerce for other merchants. We do not sell products, and are unable to assist with questions about order statuses or refunds for any merchants using our platform. Please contact the merchant you ordered from for assistance. If you’d like to report a store using Foxy for fraudulent practices, please select ‘other’ in the subject.",{"type":930},"hard_break",{"type":930},{"text":933,"type":333,"marks":934},"NOTE:",[935],{"type":936},"bold",{"text":938,"type":333}," We are ",{"text":940,"type":333,"marks":941},"not ",[942],{"type":943},"italic",{"text":945,"type":333,"marks":946},"Foxy.in",[947,951],{"type":344,"attrs":948},{"href":949,"uuid":59,"anchor":59,"custom":950,"target":59,"linktype":31},"http:\u002F\u002FFoxy.in",{},{"type":943},{"text":953,"type":333},". We are not in any way affiliated with ",{"text":945,"type":333,"marks":955},[956],{"type":344,"attrs":957},{"href":949,"uuid":59,"anchor":59,"custom":958,"target":59,"linktype":31},{},{"text":960,"type":333},", and cannot help in any way with your order from that website.","danger","global___alert","form___condition",{"_uid":965,"equals":966,"fields":967,"component":963},"8765c3e1-25cf-44aa-b8ea-fc6094acf9c3","Presales",[968],{"_uid":969,"name":970,"type":971,"label":13,"options":13,"required":24,"component":896,"conditions":972,"placeholder":13,"default_value":973},"cf464f8e-d643-4f6e-af29-d3abffaf7380","department_email_address","hidden",[],"hello@foxy.io",{"_uid":975,"equals":208,"fields":976,"component":963},"4007b6d8-77e5-421d-bd1e-6f336dd853fb",[977],{"_uid":978,"name":970,"type":971,"label":13,"options":13,"required":24,"component":896,"conditions":979,"placeholder":13,"default_value":980},"7b4c6aa5-a68c-45e0-9ce1-0a36af10c0c2",[],"help@foxy.io",{"_uid":982,"equals":983,"fields":984,"component":963},"1dbb8f11-613d-43cd-9e09-1b94f6e19219","Billing",[985],{"_uid":986,"name":970,"type":971,"label":13,"options":13,"required":24,"component":896,"conditions":987,"placeholder":13,"default_value":988},"a0ac0d1b-bc4f-4a6c-a682-581d450b0b73",[],"help+billing@foxy.io",{"_uid":990,"equals":991,"fields":992,"component":963},"a0a53a50-7172-4a29-ba58-181e38874e12","Partnerships",[993],{"_uid":994,"name":970,"type":971,"label":13,"options":13,"required":24,"component":896,"conditions":995,"placeholder":13,"default_value":996},"7aa011d9-f374-4aed-b5a5-929b54aaf152",[],"partners@foxy.io",{"_uid":998,"equals":910,"fields":999,"component":963},"a4cd431f-25d5-41c7-bfdc-02c908c8fb47",[1000],{"_uid":1001,"name":970,"type":971,"label":13,"options":13,"required":24,"component":896,"conditions":1002,"placeholder":13,"default_value":973},"f5d52168-d6ae-451b-94ee-2ced1cbd28ad",[],{"_uid":1004,"equals":1005,"fields":1006,"component":963},"25aba1ed-eb41-4bbc-aa89-f7a7167ea86e","Other",[1007],{"_uid":1008,"name":970,"type":971,"label":13,"options":13,"required":24,"component":896,"conditions":1009,"placeholder":13,"default_value":973},"f40dfaef-c203-4b71-bf4e-e1b43cef192b",[],{"_uid":1011,"component":1012},"e9c53a05-f40a-4510-aaf8-bc072a235a0c","form___subject",{"_uid":1014,"name":1015,"type":1016,"label":1017,"options":13,"required":33,"component":896,"placeholder":13},"a4c4d385-fff4-4978-99fb-b68cfea623d6","message","textarea","Message",{"_uid":1019,"name":1020,"type":904,"label":1021,"options":1022,"required":33,"component":896,"conditions":1023,"placeholder":13},"8a3c9f85-f438-427d-9c7a-d7b295a14b5b","existing_user","Are you an existing user?","No, Yes",[1024],{"_uid":1025,"equals":1026,"fields":1027,"component":963},"115933d6-262a-4b59-8fa8-579c5ad73de1","Yes",[1028],{"_uid":1029,"name":1030,"type":333,"label":1031,"options":13,"required":33,"component":896,"conditions":1032,"placeholder":13},"44b6ff23-98f0-4e95-b7f5-c23e06415c2d","subdomain","Store Subdomain",[],{"_uid":1034,"name":1035,"type":904,"label":1036,"options":1037,"required":33,"component":896,"conditions":1038,"placeholder":13},"922a5cef-3af2-4113-8855-36c7910e3ee3","user_type","What type of user are you?","Developer, Designer, Merchant",[],"POST",[1041],{"_uid":1042,"text":1043,"title":1052,"component":1053},"7323b90d-a93a-4bf1-baa9-20d0b7ead61b",{"type":324,"content":1044},[1045],{"type":335,"content":1046},[1047,1049,1050],{"text":1048,"type":333},"855.369.9227",{"type":930},{"text":1051,"type":333},"9:30am-6pm Central M-F","Pre-sales, Sales, & Partnerships","contact___footer_column",{"type":324,"content":1055},[1056],{"type":335,"content":1057},[1058],{"text":1059,"type":333},"Get in touch to get help from our friendly support team.","Submit","Success!","Your email has been received. We'll get back to you as soon as we can, but it might take a business day. If you don't hear back from us in a timely manner, please check your spam folder to ensure our reply didn't go there.",-80,[],"2fd9fb7d-a48a-4184-acfd-30022d8d6f08","2022-09-23T20:10:45.360Z",[],[288,1069,1096],{"name":1070,"created_at":1071,"published_at":1072,"updated_at":1073,"id":1074,"uuid":1075,"content":1076,"slug":1090,"full_slug":1091,"sort_by_date":59,"position":1092,"tag_list":1093,"is_startpage":24,"parent_id":310,"meta_data":59,"group_id":1094,"first_published_at":1072,"release_id":59,"lang":65,"path":59,"alternates":1095,"default_full_slug":59,"translated_slugs":59},"Taxes","2023-01-19T16:29:41.539Z","2023-01-19T17:25:33.664Z","2023-01-19T17:25:33.710Z",28247,"1cc94adb-9972-46de-8012-0b747fec3c12",{"_uid":1077,"icon":1078,"name":1070,"guides":1079,"summary":1080,"category":13,"component":297,"blog_posts":1081,"content_hub":24,"icon_custom":1082,"case_studies":1083,"faq_sections":1084,"help_articles":1085,"featured_guides":1086,"mailbox_category":13,"featured_articles":1087,"featured_blog_posts":1088,"featured_case_studies":1089},"b4d76fc5-7554-4419-af57-edc9b654cecb","fa-university",[],"How taxes work in Foxy.",[],{"id":59,"alt":59,"name":13,"focus":59,"title":59,"filename":13,"copyright":59,"fieldtype":81},[],[],[],[],[],[],[],"taxes","help\u002Fcategories\u002Ftaxes",80,[],"399e677b-f067-4896-bba6-444419d3ff29",[],{"name":1097,"created_at":1098,"published_at":1099,"updated_at":1100,"id":1101,"uuid":853,"content":1102,"slug":1115,"full_slug":1116,"sort_by_date":59,"position":1117,"tag_list":1118,"is_startpage":24,"parent_id":310,"meta_data":59,"group_id":1119,"first_published_at":1120,"release_id":59,"lang":65,"path":59,"alternates":1121,"default_full_slug":59,"translated_slugs":59},"Custom Tax Endpoint","2026-07-02T19:49:54.905Z","2026-07-06T21:04:27.011Z","2026-07-06T21:04:27.025Z",193872670377211,{"_uid":1103,"icon":13,"name":1097,"type":1104,"pinned":24,"summary":1105,"category":1075,"component":297,"blog_posts":1106,"icon_custom":1107,"case_studies":1109,"faq_sections":1110,"featured_guides":1111,"mailbox_category":13,"featured_articles":1112,"featured_blog_posts":1113,"featured_case_studies":1114},"d5af9d6e-524e-4dc0-b859-c86a775f95ce","simple","Calculate taxes with your own system when Foxy's built-in and third-party options aren't enough.",[],{"id":59,"alt":59,"name":13,"focus":59,"title":59,"source":59,"filename":13,"copyright":59,"fieldtype":81,"meta_data":1108},{},[],[],[],[],[],[],"custom-tax-endpoint","help\u002Fcategories\u002Fcustom-tax-endpoint",-560,[],"8f6745ab-2b60-4113-87aa-b5868c1dc472","2026-07-02T19:56:23.536Z",[],{},1783372633611]