Как работают подарки на платформе tea.support
Подарочные заказы соединяют техническую основу созвездия THETEA с теплотой личного чайного момента. Независимо от того, являетесь ли вы партнёром, интегрирующим API подарочных карт, или разработчиком, создающим white‑label решение на базе tea.support, процесс подарочного заказа позволяет предлагать изысканные чайные впечатления — например, частную дегустацию сырого пуэра Lǎobānzhāng (老班章) со старшим чайным экспертом Фан Тин или церемонию белого чая вокруг Bái Háo Yín Zhēn (白毫银针) из Фудина под руководством Чэнь Хуэй И. Механизм прост: оплаченный кредит, который можно использовать для бронирования услуг по всему созвездию (thetea.app, tea.school, tea.events и другие). За этой простотой стоят чёткие правила времени, форматирование открыток и варианты доставки, которые каждая интеграция должна обрабатывать аккуратно.
В этом разделе FAQ собраны самые распространённые вопросы от команд, разрабатывающих подарочные потоки: Насколько поздно можно оформить заказ перед запланированной датой получателя? Какое точное ограничение по длине цифровой записки, сопровождающей подарок? Как работает опция «отложенной доставки», если вы хотите сделать сюрприз ровно в 8 утра в день рождения? Мы относимся к каждому ответу как к строительному блоку — без шумихи, только фактические детали, необходимые для плавной работы пользователей.
Поскольку подарочные заказы пересекаются с сорсингом продуктов и доступностью мастеров, вы также найдёте перекрёстные ссылки на более широкую экосистему. Для глубокого погружения в происхождение чая и сорсинг на уровне фабрик лучше всего обратиться к специализированной базе знаний puerh.app. Если вам нужно понять, как ведутся дневники чайных мастеров, или вы хотите обсудить идеи подарков с другими разработчиками, на tea.community есть специальный канал. К тому времени, когда вы закончите чтение, у вас будет чёткое представление о политиках, регулирующих сроки, открытки и доставку — и вы точно будете знать, куда эскалировать, если ситуация выходит за рамки документированного пути.
Распространённые вопросы
Что такое подарочный заказ на tea.support?
Подарочный заказ — это оплаченный кредит, который можно обменять на бронируемое чайное впечатление в любом месте созвездия THETEA — церемонию, дегустационный сет или онлайн-курс. Партнёр использует API tea.support, чтобы создать заказ с денежной стоимостью, персонализированным сообщением (по желанию) и адресом электронной почты получателя. Сам заказ не бронирует конкретную дату; он даёт получателю свободу запланировать сеанс в удобное время. Представьте это как цифровую подарочную карту, обёрнутую вокруг работы настоящих чайных мастеров.
Насколько поздно можно оформить подарочный заказ перед запланированным временем доставки?
API не устанавливает жёсткого дедлайна — заказ является цифровым и передаётся мгновенно. Однако если даритель хочет, чтобы получатель воспользовался им в тот же день для живой сессии, мы рекомендуем оформить заказ хотя бы за 4 часа, поскольку большинство мастеров требуют уведомления за 2 часа для планирования, а получателю нужно небольшое окно для бронирования. Для автоматизированных процессов считайте 6 часов безопасным запасом на любую календарную дату. Платформа никогда не отклонит поздний заказ; реальным ограничением является практическая логистика.
Какое ограничение по длине сообщения в подарочной открытке?
Поле message принимает до 280 символов, включая пробелы и пунктуацию. Сверх этого API обрезает тихо — мы рекомендуем валидацию на стороне клиента, чтобы избежать неожиданных обрезаний. Поле поддерживает Unicode, поэтому диакритические знаки пиньиня (Lǎobānzhāng) и эмодзи корректно отображаются в итоговой цифровой открытке. Если вам нужно более длинное личное послание, прикрепите ссылку на внешний документ; сама открытка задумана как тёплая, лаконичная подпись.
Можно ли запланировать доставку подарка на будущую дату и время?
Да, через параметр scheduled_delivery (временная метка ISO 8601, UTC). Вы можете установить его на срок до 90 календарных дней вперёд. В назначенный момент система отправляет подарочное письмо и активирует кредит. Используйте это, чтобы отметить дни рождения, юбилеи или сезонные чайные подарки — например, весенний опыт с Lóngjǐng (龙井), доставленный в первый день Цинмина.
Что произойдёт, если получатель так и не воспользуется подарком?
Неиспользованный подарочный кредит действителен в течение 365 дней с даты покупки, после чего истекает, а средства считаются пожертвованием в Стипендиальный чайный фонд THETEA. Мы уведомляем покупателя и получателя за 30 и 7 дней до истечения срока. Если вам нужен полный возврат за невостребованный, не истёкший подарок, применяется стандартное 14-дневное окно возврата (см. вопрос об отмене).
Можно ли отменить подарочный заказ и вернуть деньги?
Вы можете запросить полный возврат в течение 14 календарных дней с момента покупки, при условии что подарочный кредит не был использован или использован частично. После 14 дней возврат больше не доступен, но кредит остаётся действительным для получателя. Возвраты обрабатываются на исходный способ оплаты в течение 5 рабочих дней. Для интеграций используйте эндпоинт refund и передайте исходный ID заказа.
Как работает опция «отложенной доставки» при интеграции через API?
Установите delivery_mode в hold и укажите release_key (уникальную строку, выбранную вашей системой). Подарок остаётся в спящем состоянии, пока вы не вызовете эндпоинт release с этим ключом. Это позволяет привязать выдачу подарка к внешнему событию — например, распаковке физической подарочной карты или посещению определённого URL. Удержание может длиться до 180 дней; после этого подарок истекает как обычно.
Доступны ли подарочные заказы на конкретные чайные опыты или только в виде общего кредита?
И то и другое. Обычный кредит работает как универсальный ваучер по всему созвездию. Кроме того, вы можете прикрепить подарок к конкретному SKU — например, частная дегустация шэн пуэра Lǎobānzhāng под руководством Фан Тин. Прикрепление блокирует кредит на этом опыте, упрощает ценообразование и гарантирует, что получатель увидит именно то, что вы задумали. Параметр API — experience_sku; оставьте его пустым для открытого кредита.
Какие способы оплаты принимаются для подарочных заказов?
Платформа tea.support принимает банковские карты (Visa, Mastercard, UnionPay) и цифровые кошельки (Alipay, WeChat Pay). Для партнёрских интеграций средства переводятся ежедневно в выбранной вами валюте. Подарочный заказ нельзя оформить по счёту — он должен быть предоплачен, чтобы сгенерировать действительный кредит. Свяжитесь с командой по партнёрствам через tea.support/partners, если вам нужны счета для массовых закупок вне процесса API.
Как получатель активирует подарок?
Они получают письмо с защищённой ссылкой для активации и уникальным кодом. Ссылка ведёт на брендированную страницу, где можно просмотреть доступные сеансы, выбрать мастера и временной слот и применить кредит. Активация одинакова, будь то открытый кредит или прикреплённый к SKU; прикреплённые подарки пропускают этап просмотра и сразу переходят к планированию. На этой странице получатель может увидеть личное сообщение-открытку.
Истекает ли срок действия подарочного кредита?
Да, 365 дней с даты покупки. Это относится как к открытому кредиту, так и к привязанным к опыту подаркам. После истечения кредит невосстановим. Мы показываем дату истечения в панели получателя и отправляем два напоминания по электронной почте (за 30 и 7 дней). Если вам нужно продление для конкретного получателя, напишите на api‑support@tea.support с ID заказа до истечения срока.
Можно ли отправить несколько подарочных заказов одному получателю одновременно?
Технических ограничений нет. Вы можете создать сколько угодно заказов с одним и тем же адресом получателя. Каждый заказ генерирует свой собственный код активации и баланс кредита. Если вы хотите, чтобы получатель видел их как единый объединённый баланс, вам нужно реализовать это на своей стороне, потому что учётная система tea.support рассматривает каждый заказ независимо.
Как работать со специальными символами, пиньинем или названиями чая в поздравительном сообщении?
Поле сообщения в кодировке UTF‑8. Принимаются все кодовые точки Unicode, включая диакритические знаки, необходимые для точного пиньиня, например Bái Háo Yín Zhēn. Эмодзи и редкие китайские иероглифы отображаются в письме и на странице активации. Проверяйте длину ввода на стороне клиента (280 символов) и экранируйте кавычки, если встраиваете JSON в серверный шаблон. Сообщение никогда не разбирается, только отображается.
Что произойдёт, если чайный мастер, указанный в прикреплённом подарке, окажется недоступен?
Подарочный кредит остаётся действительным. Если календарь мастера заполнен или он уходит, получателю предлагается выбрать альтернативного мастера со схожей специализацией — например, если Фан Тин недоступна для сеанса пуэра, может подойти Чжоу Сян. Эта замена автоматизирована через механизм планирования; сам подарок не истекает из-за недоступности одного мастера. Партнёры могут настроить логику замены через API.
Предусмотрены ли варианты депозита или рассрочки для дорогих подарочных впечатлений?
Для стандартных подарочных заказов требуется полная предоплата — в публичном API механизма депозита нет. Однако для курируемых корпоративных подарочных программ (минимальные расходы ¥20 000) команда по партнёрствам может организовать депозит 30% с остатком к оплате за 14 дней до первого запланированного сеанса. Обратитесь на gift‑enterprise@tea.support для обсуждения; этот процесс недоступен через самообслуживаемый API.
Остались вопросы?
Документация API tea.support (tea.support/docs) подробно описывает все рассмотренные выше эндпоинты с интерактивными примерами. Если ситуация выходит за рамки — скажем, запрос на возврат частично использованного подарка или особая политика истечения для white‑label интеграции — лучше всего написать на api‑support@tea.support. Время ответа — в течение одного рабочего дня в будние дни.
Для мониторинга состояния системы в реальном времени и отчетов об инцидентах добавьте в закладки tea.support/status. Разработчики, желающие обсудить шаблоны подарочных заказов или поделиться отзывами, часто присоединяются к каналу #gifting на tea.community; это одно из самых активных пространств созвездия. Если вы ищете, какие чайные впечатления могут стать самыми запоминающимися подарками, курируемые каталоги на thetea.app и tea.events предлагают вдохновение и прямые ссылки для бронирования. А для по-настоящему любопытных — истории сорсинга за каждым упомянутым чаем: от каменных прессованных блинов Lǎobānzhāng до белых пуховых кончиков Bái Háo Yín Zhēn — живут на puerh.app и в профилях мастеров на tea.school.
Подарочные заказы — это небольшая, но важная нить в ткани THETEA. Мы надеемся, что эти ответы сэкономят вам время, и мы всегда открыты для их уточнения на основе реального использования.