From f2862fd40a535ef03e59880efe51d3b4bd7c8403 Mon Sep 17 00:00:00 2001
From: heimrich-hannot <37208441+heimrich-hannot@users.noreply.github.com>
Date: Fri, 14 Nov 2025 21:13:43 +0100
Subject: [PATCH] Add notice about vouchers to the bulky item docs

---
 docs/notification-center/developers/_index.en.md | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/docs/notification-center/developers/_index.en.md b/docs/notification-center/developers/_index.en.md
index fb78c75..f0f1cb9 100644
--- a/docs/notification-center/developers/_index.en.md
+++ b/docs/notification-center/developers/_index.en.md
@@ -194,6 +194,13 @@ We then add a stamp to the parcel to inform the gateways about the fact that thi
 $stamps = $stamps->with(new BulkyItemsStamp($bulkyItemVouchers));
 ```
 
+Depending on the gateway you use, you may need to add the voucher to a token (this is the case for the mailer gateway):
+
+```php
+// The mailer gateway needs the vouchers comma-separated
+$tokens['attachments'] = implode(', ', $bulkyItemVouchers);
+```
+
 Done. A gateway can now use those vouchers to actually ask for the bulky items when sending them. This could
 look for example like this:
 
@@ -273,4 +280,4 @@ sure this is shown e.g. in the `TokenContext::Email` context, this is your event
 
 This event is dispatched every time a `Parcel` was sent. It can be used to implement e.g. logging, retry logic etc.
 
-[DI_Autoconfigure]: https://symfony.com/doc/current/service_container.html#the-autoconfigure-option
\ No newline at end of file
+[DI_Autoconfigure]: https://symfony.com/doc/current/service_container.html#the-autoconfigure-option