[{"data":1,"prerenderedAt":914},["ShallowReactive",2],{"navigation_docs":3,"-packages-fluentcart-readme":478,"-packages-fluentcart-readme-surround":909},[4,8,62,115,463],{"title":5,"path":6,"stem":7},"Introduction","\u002Fintroduction","0.introduction",{"title":9,"path":10,"stem":11,"children":12,"page":61},"Guides","\u002Fguides","1.guides",[13,17,21,25,29,33,37,41,45,49,53,57],{"title":14,"path":15,"stem":16},"Quickstart","\u002Fguides\u002Fquickstart","1.guides\u002F1.quickstart",{"title":18,"path":19,"stem":20},"Payouts & Settlement","\u002Fguides\u002Fpayouts","1.guides\u002F10.payouts",{"title":22,"path":23,"stem":24},"Customer Emails","\u002Fguides\u002Fcustomer-emails","1.guides\u002F11.customer-emails",{"title":26,"path":27,"stem":28},"Build your own integration","\u002Fguides\u002Fbuild-your-own-integration","1.guides\u002F2.build-your-own-integration",{"title":30,"path":31,"stem":32},"Selling Workflow","\u002Fguides\u002Fselling-workflow","1.guides\u002F2.selling-workflow",{"title":34,"path":35,"stem":36},"Vatly SDKs","\u002Fguides\u002Fsdks","1.guides\u002F3.sdks",{"title":38,"path":39,"stem":40},"Authentication","\u002Fguides\u002Fauthentication","1.guides\u002F4.authentication",{"title":42,"path":43,"stem":44},"Pagination","\u002Fguides\u002Fpagination","1.guides\u002F5.pagination",{"title":46,"path":47,"stem":48},"Errors","\u002Fguides\u002Ferrors","1.guides\u002F6.errors",{"title":50,"path":51,"stem":52},"Webhooks","\u002Fguides\u002Fwebhooks","1.guides\u002F7.webhooks",{"title":54,"path":55,"stem":56},"Idempotency","\u002Fguides\u002Fidempotency","1.guides\u002F8.idempotency",{"title":58,"path":59,"stem":60},"Testing","\u002Fguides\u002Ftesting","1.guides\u002F9.testing",false,{"title":63,"path":64,"stem":65,"children":66,"page":61},"Api Reference","\u002Fapi-reference","2.api-reference",[67,71,75,79,83,87,91,95,99,103,107,111],{"title":68,"path":69,"stem":70},"Customers","\u002Fapi-reference\u002Fcustomers","2.api-reference\u002F1.customers",{"title":72,"path":73,"stem":74},"Webhook Endpoints","\u002Fapi-reference\u002Fwebhook-endpoints","2.api-reference\u002F10.webhook-endpoints",{"title":76,"path":77,"stem":78},"Test helpers","\u002Fapi-reference\u002Ftest-helpers","2.api-reference\u002F11.test-helpers",{"title":80,"path":81,"stem":82},"Checkouts","\u002Fapi-reference\u002Fcheckouts","2.api-reference\u002F2.checkouts",{"title":84,"path":85,"stem":86},"One-off Products","\u002Fapi-reference\u002Fone-off-products","2.api-reference\u002F3.one-off-products",{"title":88,"path":89,"stem":90},"Subscriptions","\u002Fapi-reference\u002Fsubscriptions","2.api-reference\u002F4.subscriptions",{"title":92,"path":93,"stem":94},"Subscription Plans","\u002Fapi-reference\u002Fsubscription-plans","2.api-reference\u002F5.subscription-plans",{"title":96,"path":97,"stem":98},"Orders","\u002Fapi-reference\u002Forders","2.api-reference\u002F6.orders",{"title":100,"path":101,"stem":102},"Order Refunds","\u002Fapi-reference\u002Frefunds","2.api-reference\u002F7.refunds",{"title":104,"path":105,"stem":106},"Refunds","\u002Fapi-reference\u002Fglobal-refunds","2.api-reference\u002F8.global-refunds",{"title":108,"path":109,"stem":110},"Chargebacks","\u002Fapi-reference\u002Fchargebacks","2.api-reference\u002F9.chargebacks",{"title":112,"path":113,"stem":114},"Webhook Events","\u002Fapi-reference\u002Fwebhook-events","2.api-reference\u002F99.webhook-events",{"title":116,"path":117,"stem":118,"children":119},"Packages","\u002Fpackages","3.packages",[120,123,165,177,223,257,296,331,379,421],{"title":121,"path":117,"stem":122},"SDKs & Packages","3.packages\u002Findex",{"title":124,"path":125,"stem":126,"children":127,"page":61},"PHP SDK","\u002Fpackages\u002Fphp","3.packages\u002F1.php",[128,132,135,138,141,145,148,152,155,158,161],{"title":129,"path":130,"stem":131},"Getting started","\u002Fpackages\u002Fphp\u002Freadme","3.packages\u002F1.php\u002F00.readme",{"title":68,"path":133,"stem":134},"\u002Fpackages\u002Fphp\u002Fcustomers","3.packages\u002F1.php\u002F02.customers",{"title":80,"path":136,"stem":137},"\u002Fpackages\u002Fphp\u002Fcheckouts","3.packages\u002F1.php\u002F03.checkouts",{"title":88,"path":139,"stem":140},"\u002Fpackages\u002Fphp\u002Fsubscriptions","3.packages\u002F1.php\u002F04.subscriptions",{"title":142,"path":143,"stem":144},"Subscription plans","\u002Fpackages\u002Fphp\u002Fsubscriptionplans","3.packages\u002F1.php\u002F05.subscriptionplans",{"title":96,"path":146,"stem":147},"\u002Fpackages\u002Fphp\u002Forders","3.packages\u002F1.php\u002F06.orders",{"title":149,"path":150,"stem":151},"One-off products","\u002Fpackages\u002Fphp\u002Foneoffproducts","3.packages\u002F1.php\u002F07.oneoffproducts",{"title":104,"path":153,"stem":154},"\u002Fpackages\u002Fphp\u002Frefunds","3.packages\u002F1.php\u002F08.refunds",{"title":108,"path":156,"stem":157},"\u002Fpackages\u002Fphp\u002Fchargebacks","3.packages\u002F1.php\u002F09.chargebacks",{"title":50,"path":159,"stem":160},"\u002Fpackages\u002Fphp\u002Fwebhooks","3.packages\u002F1.php\u002F10.webhooks",{"title":162,"path":163,"stem":164},"Webhook URLs","\u002Fpackages\u002Fphp\u002Fwebhookendpoints","3.packages\u002F1.php\u002F11.webhookendpoints",{"title":166,"path":167,"stem":168,"children":169,"page":61},"FluentCart","\u002Fpackages\u002Ffluentcart","3.packages\u002F10.fluentcart",[170,173],{"title":129,"path":171,"stem":172},"\u002Fpackages\u002Ffluentcart\u002Freadme","3.packages\u002F10.fluentcart\u002F00.readme",{"title":174,"path":175,"stem":176},"Invoicing internals","\u002Fpackages\u002Ffluentcart\u002Fmerchant-of-record","3.packages\u002F10.fluentcart\u002F01.merchant-of-record",{"title":178,"path":179,"stem":180,"children":181,"page":61},"PHP Fluent","\u002Fpackages\u002Ffluent-php","3.packages\u002F2.fluent-php",[182,185,189,193,196,199,202,205,209,212,216,220],{"title":129,"path":183,"stem":184},"\u002Fpackages\u002Ffluent-php\u002Freadme","3.packages\u002F2.fluent-php\u002F00.readme",{"title":186,"path":187,"stem":188},"Configuration","\u002Fpackages\u002Ffluent-php\u002Fconfiguration","3.packages\u002F2.fluent-php\u002F01.configuration",{"title":190,"path":191,"stem":192},"Core concepts","\u002Fpackages\u002Ffluent-php\u002Fcoreconcepts","3.packages\u002F2.fluent-php\u002F02.coreconcepts",{"title":68,"path":194,"stem":195},"\u002Fpackages\u002Ffluent-php\u002Fcustomers","3.packages\u002F2.fluent-php\u002F03.customers",{"title":80,"path":197,"stem":198},"\u002Fpackages\u002Ffluent-php\u002Fcheckouts","3.packages\u002F2.fluent-php\u002F04.checkouts",{"title":88,"path":200,"stem":201},"\u002Fpackages\u002Ffluent-php\u002Fsubscriptions","3.packages\u002F2.fluent-php\u002F05.subscriptions",{"title":96,"path":203,"stem":204},"\u002Fpackages\u002Ffluent-php\u002Forders","3.packages\u002F2.fluent-php\u002F06.orders",{"title":206,"path":207,"stem":208},"Customer portal","\u002Fpackages\u002Ffluent-php\u002Fcustomerportal","3.packages\u002F2.fluent-php\u002F07.customerportal",{"title":50,"path":210,"stem":211},"\u002Fpackages\u002Ffluent-php\u002Fwebhooks","3.packages\u002F2.fluent-php\u002F08.webhooks",{"title":213,"path":214,"stem":215},"Webhook event flow","\u002Fpackages\u002Ffluent-php\u002Fwebhook-flow","3.packages\u002F2.fluent-php\u002F09.webhook-flow",{"title":217,"path":218,"stem":219},"Existing tables","\u002Fpackages\u002Ffluent-php\u002Fhost-owns-its-tables","3.packages\u002F2.fluent-php\u002F10.host-owns-its-tables",{"title":58,"path":221,"stem":222},"\u002Fpackages\u002Ffluent-php\u002Ftesting","3.packages\u002F2.fluent-php\u002F11.testing",{"title":224,"path":225,"stem":226,"children":227,"page":61},"Laravel","\u002Fpackages\u002Flaravel","3.packages\u002F3.laravel",[228,231,234,237,240,243,246,249,253],{"title":129,"path":229,"stem":230},"\u002Fpackages\u002Flaravel\u002Freadme","3.packages\u002F3.laravel\u002F00.readme",{"title":186,"path":232,"stem":233},"\u002Fpackages\u002Flaravel\u002Fconfiguration","3.packages\u002F3.laravel\u002F01.configuration",{"title":68,"path":235,"stem":236},"\u002Fpackages\u002Flaravel\u002Fcustomers","3.packages\u002F3.laravel\u002F02.customers",{"title":80,"path":238,"stem":239},"\u002Fpackages\u002Flaravel\u002Fcheckouts","3.packages\u002F3.laravel\u002F03.checkouts",{"title":88,"path":241,"stem":242},"\u002Fpackages\u002Flaravel\u002Fsubscriptions","3.packages\u002F3.laravel\u002F04.subscriptions",{"title":96,"path":244,"stem":245},"\u002Fpackages\u002Flaravel\u002Forders","3.packages\u002F3.laravel\u002F05.orders",{"title":50,"path":247,"stem":248},"\u002Fpackages\u002Flaravel\u002Fwebhooks","3.packages\u002F3.laravel\u002F06.webhooks",{"title":250,"path":251,"stem":252},"Comparison","\u002Fpackages\u002Flaravel\u002Fcomparison","3.packages\u002F3.laravel\u002F07.comparison",{"title":254,"path":255,"stem":256},"Migrating from Cashier","\u002Fpackages\u002Flaravel\u002Fmigrating-to-vatly","3.packages\u002F3.laravel\u002F08.migrating-to-vatly",{"title":258,"path":259,"stem":260,"children":261,"page":61},"JavaScript SDK","\u002Fpackages\u002Fjavascript","3.packages\u002F4.javascript",[262,265,268,271,274,277,280,283,286,289,292],{"title":129,"path":263,"stem":264},"\u002Fpackages\u002Fjavascript\u002Freadme","3.packages\u002F4.javascript\u002F00.readme",{"title":68,"path":266,"stem":267},"\u002Fpackages\u002Fjavascript\u002Fcustomers","3.packages\u002F4.javascript\u002F02.customers",{"title":80,"path":269,"stem":270},"\u002Fpackages\u002Fjavascript\u002Fcheckouts","3.packages\u002F4.javascript\u002F03.checkouts",{"title":88,"path":272,"stem":273},"\u002Fpackages\u002Fjavascript\u002Fsubscriptions","3.packages\u002F4.javascript\u002F04.subscriptions",{"title":142,"path":275,"stem":276},"\u002Fpackages\u002Fjavascript\u002Fsubscriptionplans","3.packages\u002F4.javascript\u002F05.subscriptionplans",{"title":96,"path":278,"stem":279},"\u002Fpackages\u002Fjavascript\u002Forders","3.packages\u002F4.javascript\u002F06.orders",{"title":149,"path":281,"stem":282},"\u002Fpackages\u002Fjavascript\u002Foneoffproducts","3.packages\u002F4.javascript\u002F07.oneoffproducts",{"title":104,"path":284,"stem":285},"\u002Fpackages\u002Fjavascript\u002Frefunds","3.packages\u002F4.javascript\u002F08.refunds",{"title":108,"path":287,"stem":288},"\u002Fpackages\u002Fjavascript\u002Fchargebacks","3.packages\u002F4.javascript\u002F09.chargebacks",{"title":50,"path":290,"stem":291},"\u002Fpackages\u002Fjavascript\u002Fwebhooks","3.packages\u002F4.javascript\u002F10.webhooks",{"title":293,"path":294,"stem":295},"API reference","\u002Fpackages\u002Fjavascript\u002Fapi","3.packages\u002F4.javascript\u002F12.api",{"title":297,"path":298,"stem":299,"children":300,"page":61},"JavaScript Fluent","\u002Fpackages\u002Ffluent-js","3.packages\u002F5.fluent-js",[301,304,307,310,313,316,319,322,325,328],{"title":129,"path":302,"stem":303},"\u002Fpackages\u002Ffluent-js\u002Freadme","3.packages\u002F5.fluent-js\u002F00.readme",{"title":186,"path":305,"stem":306},"\u002Fpackages\u002Ffluent-js\u002Fconfiguration","3.packages\u002F5.fluent-js\u002F01.configuration",{"title":190,"path":308,"stem":309},"\u002Fpackages\u002Ffluent-js\u002Fcoreconcepts","3.packages\u002F5.fluent-js\u002F02.coreconcepts",{"title":68,"path":311,"stem":312},"\u002Fpackages\u002Ffluent-js\u002Fcustomers","3.packages\u002F5.fluent-js\u002F03.customers",{"title":80,"path":314,"stem":315},"\u002Fpackages\u002Ffluent-js\u002Fcheckouts","3.packages\u002F5.fluent-js\u002F04.checkouts",{"title":88,"path":317,"stem":318},"\u002Fpackages\u002Ffluent-js\u002Fsubscriptions","3.packages\u002F5.fluent-js\u002F05.subscriptions",{"title":96,"path":320,"stem":321},"\u002Fpackages\u002Ffluent-js\u002Forders","3.packages\u002F5.fluent-js\u002F06.orders",{"title":206,"path":323,"stem":324},"\u002Fpackages\u002Ffluent-js\u002Fcustomerportal","3.packages\u002F5.fluent-js\u002F07.customerportal",{"title":50,"path":326,"stem":327},"\u002Fpackages\u002Ffluent-js\u002Fwebhooks","3.packages\u002F5.fluent-js\u002F08.webhooks",{"title":58,"path":329,"stem":330},"\u002Fpackages\u002Ffluent-js\u002Ftesting","3.packages\u002F5.fluent-js\u002F11.testing",{"title":332,"path":333,"stem":334,"children":335,"page":61},"Python SDK","\u002Fpackages\u002Fpython","3.packages\u002F6.python",[336,339,342,345,348,351,354,357,360,363,366,369,372,375],{"title":129,"path":337,"stem":338},"\u002Fpackages\u002Fpython\u002Freadme","3.packages\u002F6.python\u002F00.readme",{"title":186,"path":340,"stem":341},"\u002Fpackages\u002Fpython\u002Fconfiguration","3.packages\u002F6.python\u002F01.configuration",{"title":68,"path":343,"stem":344},"\u002Fpackages\u002Fpython\u002Fcustomers","3.packages\u002F6.python\u002F02.customers",{"title":80,"path":346,"stem":347},"\u002Fpackages\u002Fpython\u002Fcheckouts","3.packages\u002F6.python\u002F03.checkouts",{"title":88,"path":349,"stem":350},"\u002Fpackages\u002Fpython\u002Fsubscriptions","3.packages\u002F6.python\u002F04.subscriptions",{"title":142,"path":352,"stem":353},"\u002Fpackages\u002Fpython\u002Fsubscriptionplans","3.packages\u002F6.python\u002F05.subscriptionplans",{"title":96,"path":355,"stem":356},"\u002Fpackages\u002Fpython\u002Forders","3.packages\u002F6.python\u002F06.orders",{"title":149,"path":358,"stem":359},"\u002Fpackages\u002Fpython\u002Foneoffproducts","3.packages\u002F6.python\u002F07.oneoffproducts",{"title":104,"path":361,"stem":362},"\u002Fpackages\u002Fpython\u002Frefunds","3.packages\u002F6.python\u002F08.refunds",{"title":108,"path":364,"stem":365},"\u002Fpackages\u002Fpython\u002Fchargebacks","3.packages\u002F6.python\u002F09.chargebacks",{"title":50,"path":367,"stem":368},"\u002Fpackages\u002Fpython\u002Fwebhooks","3.packages\u002F6.python\u002F10.webhooks",{"title":162,"path":370,"stem":371},"\u002Fpackages\u002Fpython\u002Fwebhookendpoints","3.packages\u002F6.python\u002F11.webhookendpoints",{"title":293,"path":373,"stem":374},"\u002Fpackages\u002Fpython\u002Fapi","3.packages\u002F6.python\u002F12.api",{"title":376,"path":377,"stem":378},"Development","\u002Fpackages\u002Fpython\u002Fdevelopment","3.packages\u002F6.python\u002F13.development",{"title":380,"path":381,"stem":382,"children":383,"page":61},"Python Fluent","\u002Fpackages\u002Ffluent-python","3.packages\u002F7.fluent-python",[384,387,390,393,396,399,402,405,408,411,414,418],{"title":129,"path":385,"stem":386},"\u002Fpackages\u002Ffluent-python\u002Freadme","3.packages\u002F7.fluent-python\u002F00.readme",{"title":186,"path":388,"stem":389},"\u002Fpackages\u002Ffluent-python\u002Fconfiguration","3.packages\u002F7.fluent-python\u002F01.configuration",{"title":190,"path":391,"stem":392},"\u002Fpackages\u002Ffluent-python\u002Fcoreconcepts","3.packages\u002F7.fluent-python\u002F02.coreconcepts",{"title":68,"path":394,"stem":395},"\u002Fpackages\u002Ffluent-python\u002Fcustomers","3.packages\u002F7.fluent-python\u002F03.customers",{"title":80,"path":397,"stem":398},"\u002Fpackages\u002Ffluent-python\u002Fcheckouts","3.packages\u002F7.fluent-python\u002F04.checkouts",{"title":88,"path":400,"stem":401},"\u002Fpackages\u002Ffluent-python\u002Fsubscriptions","3.packages\u002F7.fluent-python\u002F05.subscriptions",{"title":96,"path":403,"stem":404},"\u002Fpackages\u002Ffluent-python\u002Forders","3.packages\u002F7.fluent-python\u002F06.orders",{"title":206,"path":406,"stem":407},"\u002Fpackages\u002Ffluent-python\u002Fcustomerportal","3.packages\u002F7.fluent-python\u002F07.customerportal",{"title":50,"path":409,"stem":410},"\u002Fpackages\u002Ffluent-python\u002Fwebhooks","3.packages\u002F7.fluent-python\u002F08.webhooks",{"title":58,"path":412,"stem":413},"\u002Fpackages\u002Ffluent-python\u002Ftesting","3.packages\u002F7.fluent-python\u002F11.testing",{"title":415,"path":416,"stem":417},"Porting","\u002Fpackages\u002Ffluent-python\u002Fporting","3.packages\u002F7.fluent-python\u002F12.porting",{"title":376,"path":419,"stem":420},"\u002Fpackages\u002Ffluent-python\u002Fdevelopment","3.packages\u002F7.fluent-python\u002F13.development",{"title":422,"path":423,"stem":424,"children":425,"page":61},"Django","\u002Fpackages\u002Fdjango","3.packages\u002F8.django",[426,429,433,436,440,444,447,450,453,457,460],{"title":129,"path":427,"stem":428},"\u002Fpackages\u002Fdjango\u002Freadme","3.packages\u002F8.django\u002F00.readme",{"title":430,"path":431,"stem":432},"Installation","\u002Fpackages\u002Fdjango\u002Finstallation","3.packages\u002F8.django\u002F01.installation",{"title":186,"path":434,"stem":435},"\u002Fpackages\u002Fdjango\u002Fconfiguration","3.packages\u002F8.django\u002F02.configuration",{"title":437,"path":438,"stem":439},"Billable models","\u002Fpackages\u002Fdjango\u002Fbillablemodels","3.packages\u002F8.django\u002F03.billablemodels",{"title":441,"path":442,"stem":443},"Checkout","\u002Fpackages\u002Fdjango\u002Fcheckout","3.packages\u002F8.django\u002F04.checkout",{"title":88,"path":445,"stem":446},"\u002Fpackages\u002Fdjango\u002Fbilling","3.packages\u002F8.django\u002F05.billing",{"title":206,"path":448,"stem":449},"\u002Fpackages\u002Fdjango\u002Fcustomerportal","3.packages\u002F8.django\u002F06.customerportal",{"title":50,"path":451,"stem":452},"\u002Fpackages\u002Fdjango\u002Fwebhooks","3.packages\u002F8.django\u002F07.webhooks",{"title":454,"path":455,"stem":456},"Admin","\u002Fpackages\u002Fdjango\u002Fadmin","3.packages\u002F8.django\u002F08.admin",{"title":58,"path":458,"stem":459},"\u002Fpackages\u002Fdjango\u002Ftesting","3.packages\u002F8.django\u002F09.testing",{"title":376,"path":461,"stem":462},"\u002Fpackages\u002Fdjango\u002Fdevelopment","3.packages\u002F8.django\u002F10.development",{"title":464,"path":465,"stem":466,"children":467},"Integrations","\u002Fintegrations","4.integrations",[468,470,474],{"title":464,"path":465,"stem":469},"4.integrations\u002Findex",{"title":471,"path":472,"stem":473},"Lovable payments with Vatly","\u002Fintegrations\u002Flovable","4.integrations\u002F1.lovable",{"title":475,"path":476,"stem":477},"Bolt payments with Vatly","\u002Fintegrations\u002Fbolt","4.integrations\u002F2.bolt",{"id":479,"title":166,"body":480,"description":902,"extension":903,"links":904,"meta":905,"navigation":906,"path":171,"seo":907,"stem":172,"__hash__":908},"docs\u002F3.packages\u002F10.fluentcart\u002F00.readme.md",{"type":481,"value":482,"toc":893},"minimark",[483,487,495,500,534,538,564,567,586,598,609,613,706,710,716,756,767,773,776,779,799,810,813,816,881,889],[484,485,486],"p",{},"Accept payments through Vatly in FluentCart, the WordPress e-commerce plugin.\nVatly is the European Merchant of Record for AI, software and digital products.\nThis plugin registers Vatly as a FluentCart payment gateway and builds on PHP Fluent and the PHP SDK.",[488,489,490,494],"warning",{},[491,492,493],"strong",{},"Alpha."," The plugin works end to end with Vatly test mode on FluentCart 2.3, but it\ncan still change in ways that need you to update your setup. Try it in Vatly test mode\nbefore you take live payments with it.",[496,497,499],"h2",{"id":498},"what-it-does","What it does",[501,502,503,510,516,522,528],"ul",{},[504,505,506,509],"li",{},[491,507,508],{},"Merchant-of-Record checkout"," for one-off products and subscriptions, including free trials carried over from FluentCart.",[504,511,512,515],{},[491,513,514],{},"Official Vatly invoices"," on the FluentCart receipt and as shortcodes. FluentCart's own competing receipt email is suppressed for Vatly orders, so customers never receive two invoices for one purchase.",[504,517,518,521],{},[491,519,520],{},"Refunds routed through Vatly",", so Vatly issues the credit note and its VAT, and the result is recorded on the FluentCart order.",[504,523,524,527],{},[491,525,526],{},"FluentCart's own events"," for every payment and subscription change, including renewals, failed payments, refunds, cancellations and chargebacks, so other plugins that listen to FluentCart keep working.",[504,529,530,533],{},[491,531,532],{},"Per-record test and live mode",", frozen at checkout, so refunds always use the API key that matches the original order.",[496,535,537],{"id":536},"requirements","Requirements",[501,539,540,543,546,555],{},[504,541,542],{},"WordPress 6.2 or newer",[504,544,545],{},"PHP 8.1 or newer",[504,547,548,554],{},[549,550,166],"a",{"href":551,"rel":552},"https:\u002F\u002Ffluentcart.com",[553],"nofollow"," 2.3 or newer, installed and active",[504,556,557,558,563],{},"A ",[549,559,562],{"href":560,"rel":561},"https:\u002F\u002Fvatly.com",[553],"Vatly"," account with test-mode API credentials",[496,565,430],{"id":566},"installation",[568,569,570,579],"ol",{},[504,571,572,573,578],{},"Download the zip from the ",[549,574,577],{"href":575,"rel":576},"https:\u002F\u002Fgithub.com\u002Fvatly\u002Fvatly-fluentcart-wp\u002Freleases\u002Flatest",[553],"latest alpha release",". It includes the plugin's dependencies, so you don't need Composer.",[504,580,581,582,585],{},"In WordPress, go to ",[491,583,584],{},"Plugins → Add New → Upload Plugin",", choose the zip, and activate it.",[484,587,588,589,593,594,597],{},"To build the zip yourself, run ",[590,591,592],"code",{},"bin\u002Fbuild-release.sh"," in a clone of the repository. It produces ",[590,595,596],{},"build\u002Fvatly-for-fluentcart.zip"," with a namespace-scoped copy of the dependencies, and needs PHP, Composer, curl and zip.",[484,599,600,601,604,605,608],{},"For development, run ",[590,602,603],{},"composer install"," in the clone instead, then place or symlink the directory in ",[590,606,607],{},"wp-content\u002Fplugins\u002F",".",[496,610,612],{"id":611},"setup","Setup",[568,614,615,641,668],{},[504,616,617,620,621,624,625,628,629,632,633,636,637,640],{},[491,618,619],{},"Add your API credentials."," Go to ",[491,622,623],{},"FluentCart → Settings → Payment Methods → Vatly",", choose ",[491,626,627],{},"Test"," mode, and paste the test ",[491,630,631],{},"API key"," and ",[491,634,635],{},"Webhook secret"," from the ",[491,638,639],{},"Developers"," section of your Vatly dashboard.",[504,642,643,646,647,649,650,660,663,664,667],{},[491,644,645],{},"Register the webhook in Vatly."," Under ",[491,648,639],{}," in the Vatly dashboard, add a webhook endpoint pointing at:",[651,652,658],"pre",{"className":653,"code":655,"language":656,"meta":657},[654],"language-text","https:\u002F\u002Fyour-site.com\u002Fwp-admin\u002Fadmin-ajax.php?action=fluent_cart_vatly_webhook\n","text","",[590,659,655],{"__ignoreMap":657},[661,662],"br",{},"Use the webhook secret you entered above. Vatly's ",[590,665,666],{},"order.paid"," webhook stamps the official invoice onto each order.",[504,669,670,673,674,677,678,681,682,703,705],{},[491,671,672],{},"Map your products to Vatly."," Edit a FluentCart product and fill in the ",[491,675,676],{},"Vatly mapping"," box with the IDs from ",[491,679,680],{},"Manage Products"," in your Vatly dashboard:",[501,683,684,694],{},[504,685,686,689,690,693],{},[491,687,688],{},"Vatly product ID",": the ",[590,691,692],{},"one_off_product_…"," ID, for one-time products.",[504,695,696,689,699,702],{},[491,697,698],{},"Vatly plan ID",[590,700,701],{},"subscription_plan_…"," ID, for subscription products.",[661,704],{},"A checkout fails with a clear error when the product it sells has no matching Vatly ID.",[496,707,709],{"id":708},"invoices","Invoices",[484,711,712,713,715],{},"Vatly issues the legally valid VAT invoice and, for refunds, the credit note. When a Vatly ",[590,714,666],{}," webhook arrives, the plugin stores the Vatly invoice URL on the FluentCart order and the credit-note URL on refunds. Show the invoice anywhere FluentCart accepts shortcodes:",[717,718,719,732],"table",{},[720,721,722],"thead",{},[723,724,725,729],"tr",{},[726,727,728],"th",{},"Shortcode",[726,730,731],{},"Output",[733,734,735,746],"tbody",{},[723,736,737,743],{},[738,739,740],"td",{},[590,741,742],{},"[vatly_invoice_link]",[738,744,745],{},"A plain \"Download official Vatly invoice\" link.",[723,747,748,753],{},[738,749,750],{},[590,751,752],{},"[vatly_invoice_button]",[738,754,755],{},"The same link, styled as a button.",[484,757,758,759,762,763,766],{},"Both accept an optional ",[590,760,761],{},"order_id",", for example ",[590,764,765],{},"[vatly_invoice_link order_id=\"123\"]","; otherwise they use FluentCart's current order. They render nothing for orders without a Vatly invoice, so they are safe in templates shared with other gateways. The invoice button also appears automatically on the FluentCart receipt page.",[484,768,769,770,608],{},"For the FluentCart hooks the invoicing relies on, see ",[549,771,772],{"href":175},"Merchant-of-Record invoicing",[496,774,104],{"id":775},"refunds",[484,777,778],{},"Refunds issued from the FluentCart admin go through Vatly, then are recorded on the FluentCart transaction.",[501,780,781,787,793],{},[504,782,783,786],{},[491,784,785],{},"Full refunds"," are supported.",[504,788,789,792],{},[491,790,791],{},"Partial refunds on single-item orders"," are refunded against the order's line.",[504,794,795,798],{},[491,796,797],{},"Partial refunds on multi-item orders"," are not supported from FluentCart. Issue a full refund, or refund a specific line from the Vatly dashboard.",[484,800,801,802,805,806,809],{},"Vatly refunds are asynchronous: the FluentCart refund starts with Vatly's initial status, usually ",[590,803,804],{},"pending",", and moves to ",[590,807,808],{},"refunded"," once Vatly confirms it.",[484,811,812],{},"Each FluentCart transaction keeps the mode (test or live) it had at checkout. Refunds use the API key for that record's mode, not the gateway's current setting.",[496,814,376],{"id":815},"development",[651,817,821],{"className":818,"code":819,"language":820,"meta":657,"style":657},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","composer install\ncomposer test:unit          # PHPUnit unit suite\ncomposer test:integration   # integration suite (see docker\u002F for a WordPress + FluentCart environment)\ncomposer analyse            # PHPStan\ncomposer phpcs              # WordPress coding standards\n","bash",[590,822,823,836,848,859,870],{"__ignoreMap":657},[824,825,828,832],"span",{"class":826,"line":827},"line",1,[824,829,831],{"class":830},"sBMFI","composer",[824,833,835],{"class":834},"sfazB"," install\n",[824,837,839,841,844],{"class":826,"line":838},2,[824,840,831],{"class":830},[824,842,843],{"class":834}," test:unit",[824,845,847],{"class":846},"sHwdD","          # PHPUnit unit suite\n",[824,849,851,853,856],{"class":826,"line":850},3,[824,852,831],{"class":830},[824,854,855],{"class":834}," test:integration",[824,857,858],{"class":846},"   # integration suite (see docker\u002F for a WordPress + FluentCart environment)\n",[824,860,862,864,867],{"class":826,"line":861},4,[824,863,831],{"class":830},[824,865,866],{"class":834}," analyse",[824,868,869],{"class":846},"            # PHPStan\n",[824,871,873,875,878],{"class":826,"line":872},5,[824,874,831],{"class":830},[824,876,877],{"class":834}," phpcs",[824,879,880],{"class":846},"              # WordPress coding standards\n",[484,882,883,884,608],{},"The source and issue tracker are on ",[549,885,888],{"href":886,"rel":887},"https:\u002F\u002Fgithub.com\u002Fvatly\u002Fvatly-fluentcart-wp",[553],"GitHub",[890,891,892],"style",{},"html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html pre.shiki code .sHwdD, html code.shiki .sHwdD{--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#546E7A;--shiki-default-font-style:italic;--shiki-dark:#676E95;--shiki-dark-font-style:italic}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"title":657,"searchDepth":838,"depth":838,"links":894},[895,896,897,898,899,900,901],{"id":498,"depth":838,"text":499},{"id":536,"depth":838,"text":537},{"id":566,"depth":838,"text":430},{"id":611,"depth":838,"text":612},{"id":708,"depth":838,"text":709},{"id":775,"depth":838,"text":104},{"id":815,"depth":838,"text":376},"Accept payments through Vatly in FluentCart, the WordPress e-commerce plugin.","md",null,{},{"title":129},{"title":166,"description":902},"whHCHK9lywsSWzos8ORaQE0e04KJzacya4ragygIJ6c",[910,912],{"title":162,"path":163,"stem":164,"description":911,"children":-1},"A webhook endpoint is the HTTPS URL Vatly POSTs event deliveries to — registered from code (or infrastructure-as-code) rather than the dashboard.",{"title":174,"path":175,"stem":176,"description":913,"children":-1},"How the plugin makes Vatly the single source of truth for invoices on FluentCart orders, and the FluentCart integration points it relies on.",1795088426997]