[{"data":1,"prerenderedAt":545},["ShallowReactive",2],{"navigation_docs":3,"-guides-customer-emails":198,"-guides-customer-emails-surround":540},[4,8,58,111,194],{"title":5,"path":6,"stem":7},"Introduction","\u002Fintroduction","0.introduction",{"title":9,"path":10,"stem":11,"children":12,"page":57},"Guides","\u002Fguides","1.guides",[13,17,21,25,29,33,37,41,45,49,53],{"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},"Selling Workflow","\u002Fguides\u002Fselling-workflow","1.guides\u002F2.selling-workflow",{"title":30,"path":31,"stem":32},"Vatly SDKs","\u002Fguides\u002Fsdks","1.guides\u002F3.sdks",{"title":34,"path":35,"stem":36},"Authentication","\u002Fguides\u002Fauthentication","1.guides\u002F4.authentication",{"title":38,"path":39,"stem":40},"Pagination","\u002Fguides\u002Fpagination","1.guides\u002F5.pagination",{"title":42,"path":43,"stem":44},"Errors","\u002Fguides\u002Ferrors","1.guides\u002F6.errors",{"title":46,"path":47,"stem":48},"Webhooks","\u002Fguides\u002Fwebhooks","1.guides\u002F7.webhooks",{"title":50,"path":51,"stem":52},"Idempotency","\u002Fguides\u002Fidempotency","1.guides\u002F8.idempotency",{"title":54,"path":55,"stem":56},"Testing","\u002Fguides\u002Ftesting","1.guides\u002F9.testing",false,{"title":59,"path":60,"stem":61,"children":62,"page":57},"Api Reference","\u002Fapi-reference","2.api-reference",[63,67,71,75,79,83,87,91,95,99,103,107],{"title":64,"path":65,"stem":66},"Customers","\u002Fapi-reference\u002Fcustomers","2.api-reference\u002F1.customers",{"title":68,"path":69,"stem":70},"Webhook Endpoints","\u002Fapi-reference\u002Fwebhook-endpoints","2.api-reference\u002F10.webhook-endpoints",{"title":72,"path":73,"stem":74},"Test helpers","\u002Fapi-reference\u002Ftest-helpers","2.api-reference\u002F11.test-helpers",{"title":76,"path":77,"stem":78},"Checkouts","\u002Fapi-reference\u002Fcheckouts","2.api-reference\u002F2.checkouts",{"title":80,"path":81,"stem":82},"One-off Products","\u002Fapi-reference\u002Fone-off-products","2.api-reference\u002F3.one-off-products",{"title":84,"path":85,"stem":86},"Subscriptions","\u002Fapi-reference\u002Fsubscriptions","2.api-reference\u002F4.subscriptions",{"title":88,"path":89,"stem":90},"Subscription Plans","\u002Fapi-reference\u002Fsubscription-plans","2.api-reference\u002F5.subscription-plans",{"title":92,"path":93,"stem":94},"Orders","\u002Fapi-reference\u002Forders","2.api-reference\u002F6.orders",{"title":96,"path":97,"stem":98},"Order Refunds","\u002Fapi-reference\u002Frefunds","2.api-reference\u002F7.refunds",{"title":100,"path":101,"stem":102},"Refunds","\u002Fapi-reference\u002Fglobal-refunds","2.api-reference\u002F8.global-refunds",{"title":104,"path":105,"stem":106},"Chargebacks","\u002Fapi-reference\u002Fchargebacks","2.api-reference\u002F9.chargebacks",{"title":108,"path":109,"stem":110},"Webhook Events","\u002Fapi-reference\u002Fwebhook-events","2.api-reference\u002F99.webhook-events",{"title":112,"path":113,"stem":114,"children":115},"Packages","\u002Fpackages","3.packages",[116,119,159],{"title":117,"path":113,"stem":118},"","3.packages\u002Findex",{"title":120,"path":121,"stem":122,"children":123,"page":57},"Php","\u002Fpackages\u002Fphp","3.packages\u002F1.php",[124,128,131,134,137,140,143,146,150,153,156],{"title":125,"path":126,"stem":127},"Getting Started","\u002Fpackages\u002Fphp\u002Freadme","3.packages\u002F1.php\u002F0.readme",{"title":64,"path":129,"stem":130},"\u002Fpackages\u002Fphp\u002Fcustomers","3.packages\u002F1.php\u002F1.customers",{"title":76,"path":132,"stem":133},"\u002Fpackages\u002Fphp\u002Fcheckouts","3.packages\u002F1.php\u002F2.checkouts",{"title":84,"path":135,"stem":136},"\u002Fpackages\u002Fphp\u002Fsubscriptions","3.packages\u002F1.php\u002F3.subscriptions",{"title":88,"path":138,"stem":139},"\u002Fpackages\u002Fphp\u002Fsubscriptionplans","3.packages\u002F1.php\u002F4.subscriptionplans",{"title":92,"path":141,"stem":142},"\u002Fpackages\u002Fphp\u002Forders","3.packages\u002F1.php\u002F5.orders",{"title":100,"path":144,"stem":145},"\u002Fpackages\u002Fphp\u002Frefunds","3.packages\u002F1.php\u002F6.refunds",{"title":147,"path":148,"stem":149},"One-Off Products","\u002Fpackages\u002Fphp\u002Foneoffproducts","3.packages\u002F1.php\u002F7.oneoffproducts",{"title":104,"path":151,"stem":152},"\u002Fpackages\u002Fphp\u002Fchargebacks","3.packages\u002F1.php\u002F8.chargebacks",{"title":46,"path":154,"stem":155},"\u002Fpackages\u002Fphp\u002Fwebhooks","3.packages\u002F1.php\u002F9.webhooks",{"title":68,"path":157,"stem":158},"\u002Fpackages\u002Fphp\u002Fwebhookendpoints","3.packages\u002F1.php\u002F99.webhookendpoints",{"title":160,"path":161,"stem":162,"children":163,"page":57},"Laravel","\u002Fpackages\u002Flaravel","3.packages\u002F2.laravel",[164,167,170,173,176,179,182,186,190],{"title":125,"path":165,"stem":166},"\u002Fpackages\u002Flaravel\u002Freadme","3.packages\u002F2.laravel\u002F0.readme",{"title":64,"path":168,"stem":169},"\u002Fpackages\u002Flaravel\u002Fcustomers","3.packages\u002F2.laravel\u002F1.customers",{"title":76,"path":171,"stem":172},"\u002Fpackages\u002Flaravel\u002Fcheckouts","3.packages\u002F2.laravel\u002F2.checkouts",{"title":84,"path":174,"stem":175},"\u002Fpackages\u002Flaravel\u002Fsubscriptions","3.packages\u002F2.laravel\u002F3.subscriptions",{"title":92,"path":177,"stem":178},"\u002Fpackages\u002Flaravel\u002Forders","3.packages\u002F2.laravel\u002F4.orders",{"title":46,"path":180,"stem":181},"\u002Fpackages\u002Flaravel\u002Fwebhooks","3.packages\u002F2.laravel\u002F5.webhooks",{"title":183,"path":184,"stem":185},"Vs Cashier (Stripe, Paddle) & Lemon Squeezy","\u002Fpackages\u002Flaravel\u002Fcomparison","3.packages\u002F2.laravel\u002F6.comparison",{"title":187,"path":188,"stem":189},"Migrating from Cashier","\u002Fpackages\u002Flaravel\u002Fmigrating-to-vatly","3.packages\u002F2.laravel\u002F7.migrating-to-vatly",{"title":191,"path":192,"stem":193},"Configuration","\u002Fpackages\u002Flaravel\u002Fconfiguration","3.packages\u002F2.laravel\u002F99.configuration",{"title":195,"path":196,"stem":197},"Integrations","\u002Fintegrations","4.integrations",{"id":199,"title":22,"body":200,"description":533,"extension":534,"links":535,"meta":536,"navigation":537,"path":23,"seo":538,"stem":24,"__hash__":539},"docs\u002F1.guides\u002F11.customer-emails.md",{"type":201,"value":202,"toc":520},"minimark",[203,208,212,220,224,227,249,257,261,297,300,303,347,350,354,390,394,397,417,420,423,440,443,463,467,487,494,498,504,508,511],[204,205,207],"h2",{"id":206},"vatly-sends-the-billing-emails","Vatly sends the billing emails",[209,210,211],"p",{},"As Merchant of Record, Vatly is the seller on your customer's invoice. That makes Vatly responsible for the billing communication with your customers, so you don't need to build receipts, payment reminders or refund confirmations yourself.",[209,213,214,215,219],{},"Vatly sends these emails automatically. Use ",[216,217,218],"a",{"href":47},"webhooks"," to keep your own application in sync, for example to grant or revoke access. Anything about your product itself, such as onboarding or usage emails, stays with you.",[204,221,223],{"id":222},"what-your-customers-see","What your customers see",[209,225,226],{},"Every customer email:",[228,229,230,234,237,246],"ul",{},[231,232,233],"li",{},"Shows your storefront name and logo in the header",[231,235,236],{},"Is sent by Vatly, and states that the sale is made by Vatly",[231,238,239,240],{},"Points billing and payment questions to ",[216,241,245],{"href":242,"rel":243},"https:\u002F\u002Fvatly.com\u002Fsupport",[244],"nofollow","Vatly support",[231,247,248],{},"Is written in English",[209,250,251,252,256],{},"Set your storefront name and logo in the Vatly dashboard under ",[253,254,255],"strong",{},"Settings » Branding",". Until you set a name, customers see a placeholder name in their emails.",[204,258,260],{"id":259},"purchases-and-invoices","Purchases and invoices",[262,263,264,277],"table",{},[265,266,267],"thead",{},[268,269,270,274],"tr",{},[271,272,273],"th",{},"Email",[271,275,276],{},"When it is sent",[278,279,280,289],"tbody",{},[268,281,282,286],{},[283,284,285],"td",{},"Receipt",[283,287,288],{},"After every successful payment: a one-off purchase, the first payment of a subscription, and every renewal. It lists the items, any discount and the VAT, and links to the invoice.",[268,290,291,294],{},[283,292,293],{},"Invoice link",[283,295,296],{},"When a customer opens an expired invoice link and requests a new one.",[209,298,299],{},"Each order gets one receipt. The receipt links to the invoice in the customer portal instead of attaching a PDF.",[204,301,84],{"id":302},"subscriptions",[262,304,305,313],{},[265,306,307],{},[268,308,309,311],{},[271,310,273],{},[271,312,276],{},[278,314,315,323,331,339],{},[268,316,317,320],{},[283,318,319],{},"Upcoming renewal",[283,321,322],{},"Ahead of the renewal of a subscription billed less often than monthly, or of its first charge after a free trial. It shows the amount, the date and how to cancel.",[268,324,325,328],{},[283,326,327],{},"Payment initiated",[283,329,330],{},"When Vatly starts a recurring payment, such as a renewal. It shows the amount, the payment method and the expected charge date.",[268,332,333,336],{},[283,334,335],{},"Cancellation confirmation",[283,337,338],{},"When the customer cancels their subscription in the customer portal. It confirms until when they keep access.",[268,340,341,344],{},[283,342,343],{},"Cancellation notice",[283,345,346],{},"When you cancel a subscription through the API, or Vatly cancels it on your behalf. It tells the customer when their access ends.",[209,348,349],{},"The upcoming renewal email goes out 7 days ahead for plans billed up to every 3 months, 14 days ahead for plans up to every 6 months, and 30 days ahead for longer plans. Monthly and shorter plans don't get one. If the renewal changes after the email went out, for example because you scheduled a plan change, the customer gets an updated email.",[204,351,353],{"id":352},"payment-methods","Payment methods",[262,355,356,364],{},[265,357,358],{},[268,359,360,362],{},[271,361,273],{},[271,363,276],{},[278,365,366,374,382],{},[268,367,368,371],{},[283,369,370],{},"Card expiring",[283,372,373],{},"When the card used for a subscription is about to expire. It asks the customer to update their payment method.",[268,375,376,379],{},[283,377,378],{},"Recurring payment setup failed",[283,380,381],{},"When a recurring payment could not be set up because the customer's first payment never completed. It asks the customer to set up their payment method again.",[268,383,384,387],{},[283,385,386],{},"Payment method update link",[283,388,389],{},"When a customer opens an expired payment method update link and requests a new one.",[204,391,393],{"id":392},"failed-payments","Failed payments",[209,395,396],{},"When a recurring payment fails, Vatly starts a payment recovery process for the subscription. The customer receives:",[398,399,400,407,410],"ol",{},[231,401,402,403,406],{},"A ",[253,404,405],{},"Payment failed"," email straight away.",[231,408,409],{},"A series of reminders while Vatly retries the payment. The reminders become more urgent as the process continues, ending with a final notice.",[231,411,412,413,416],{},"If the payment still fails, a ",[253,414,415],{},"Service canceled"," email. Vatly cancels the subscriptions that use the failed payment method.",[209,418,419],{},"When the payment method can't be charged at all, for example because the card is no longer valid, Vatly does not retry. Instead, the customer receives reminders to update their payment method.",[209,421,422],{},"As soon as a retry succeeds or the customer adds a working payment method, the reminders stop and the customer receives the usual receipt.",[209,424,425,426,430,431,434,435,439],{},"Follow the process on your side with the ",[427,428,429],"code",{},"order.payment_failed"," and ",[427,432,433],{},"order.paid"," webhooks. See ",[216,436,438],{"href":437},"\u002Fguides\u002Fwebhooks#handling-failed-subscription-payments","Handling failed subscription payments",".",[204,441,100],{"id":442},"refunds",[262,444,445,453],{},[265,446,447],{},[268,448,449,451],{},[271,450,273],{},[271,452,276],{},[278,454,455],{},[268,456,457,460],{},[283,458,459],{},"Refund processed",[283,461,462],{},"When a refund is completed, whether you created it through the API or the dashboard. It lists the refunded items and the total.",[204,464,466],{"id":465},"customer-portal","Customer portal",[262,468,469,477],{},[265,470,471],{},[268,472,473,475],{},[271,474,273],{},[271,476,276],{},[278,478,479],{},[268,480,481,484],{},[283,482,483],{},"Sign-in link",[283,485,486],{},"When a customer requests a sign-in link on the customer portal login page.",[209,488,489,493],{},[216,490,492],{"href":491},"\u002Fapi-reference\u002Fcustomers#create-a-customer-portal-session","Customer portal sessions"," created through the API return a URL and do not send an email.",[204,495,497],{"id":496},"test-mode","Test mode",[209,499,500,501,439],{},"Emails for test mode orders are never delivered to a real inbox. Vatly still renders and saves them, so you can review what your customer would receive. Open an order in the dashboard and find its emails under ",[253,502,503],{},"Emails",[204,505,507],{"id":506},"customization","Customization",[209,509,510],{},"You can't turn off these emails. Most of them are required for Vatly to bill your customers correctly, such as the receipt and the invoice.",[209,512,513,514,519],{},"Additional email branding is on the ",[216,515,518],{"href":516,"rel":517},"https:\u002F\u002Froadmap.vatly.com\u002Fprojects\u002F2-merchant-ui\u002Fitems\u002F26-email-co-branding",[244],"roadmap",". Vote for it to let us know it matters to you.",{"title":117,"searchDepth":521,"depth":521,"links":522},2,[523,524,525,526,527,528,529,530,531,532],{"id":206,"depth":521,"text":207},{"id":222,"depth":521,"text":223},{"id":259,"depth":521,"text":260},{"id":302,"depth":521,"text":84},{"id":352,"depth":521,"text":353},{"id":392,"depth":521,"text":393},{"id":442,"depth":521,"text":100},{"id":465,"depth":521,"text":466},{"id":496,"depth":521,"text":497},{"id":506,"depth":521,"text":507},"The billing emails Vatly sends to your customers as Merchant of Record, when each one is sent, and what you can configure.","md",null,{},true,{"title":22,"description":533},"KQplrqzW8QmbwPoNSET79GU0GAEN2QYnCfJyX1CzkF4",[541,543],{"title":18,"path":19,"stem":20,"description":542,"children":-1},"How and when your share of each payment reaches your Mollie account, and where to follow it in the dashboard.",{"title":26,"path":27,"stem":28,"description":544,"children":-1},"Follow the typical Vatly happy path from account setup to product delivery, and prepare for refunds and chargebacks.",1791995637602]