Подготовка систем к работе с Shop Cash

Прежде чем запускать рабочие процессы Shop Cash со сторонними системами, подтвердите соблюдение следующих требований:

• Ваши системы ERP, OMS, системы выполнения заказов, бухгалтерского учета и возвратов могут принимать более одного способа оплаты для одного заказа.
• shop_cash сопоставляется как способ оплаты, когда доступны значения шлюза.
• Shop Cash не рассматривается как скидка, подарочная карта или кредит магазина.
• Значение авторизации хранится как непрозрачная строка переменной длины, состоящая не менее чем из 1024 символов. По возможности используйте неограниченное текстовое поле.
• Списания, аннулирования и возвраты платежей идентифицируются по ИД транзакции, а не по значению авторизации. Операции списания и аннулирования в Admin API используют parentTransactionId, а операции возврата платежей — parentId.
• Ваши системы не анализируют, не декодируют, не нормализуют, не хешируют и не усекают значения авторизации Shop Cash.
• Ваши системы могут обрабатывать сгруппированные выплаты, где одна строка shop_cash_credit может представлять несколько заказов.
• Ваш рабочий процесс сверки не предполагает, что одному заказу соответствует одна строка выплаты.
• Ваш рабочий процесс сверки может справляться с тем, что часть Shop Cash и часть, оплаченная картой или через Рассрочку Shop Pay, рассчитываются в разных выплатах.
• Ваш рабочий процесс возврата платежей может обрабатывать частичные возвраты платежей по карте или через Рассрочку Shop Pay и Shop Cash.
• Приложения для возврата платежей могут возвращать средства за транзакцию списания Shop Cash, а не за транзакцию авторизации.
• Если вы проводили Shop Campaigns до января 2026 года, ваш финансовый рабочий процесс обрабатывает прошлые строки shop_cash_campaign_billing_debit и связанные строки счетов за кампанию отдельно от выручки за заказы. С января 2026 года расходы на кампанию будут включаться в ваш счет Shopify.

Тестирование Shop Cash имеет ограничения, поскольку этот способ оплаты зависит от аккаунтов покупателей Shop, балансов Shop Cash, инфраструктуры Shopify Payments и расчетов Shop Cash.

Самый надежный способ полностью проверить корпоративную интеграцию — разместить рабочий заказ на небольшую сумму через Shop, а затем выполнить по нему возврат платежа. При этом создаются приближенные к реальным транзакции заказов, данные о списании, действия по выплатам, транзакции возврата платежей и действия по дебетованию возврата платежей, которые проходят через панель администратора Shopify, данные Admin API, экспорт выплат и данные API выплат.

Магазины разработки могут помочь проверить некоторые формы полей API и логику сопоставления, но с их помощью невозможно достоверно проверить все этапы оформления заказа в Shop, баланс покупателя и процесс расчетов. Тестовый режим и фиктивный шлюз не создают строк выплат Shop Cash, аналогичных рабочим, поскольку не используют реальный процесс расчетов Shopify Payments.

Обычно можно протестировать следующие рабочие процессы с помощью рабочего заказа на небольшую сумму, инициированного в Shop:

• Прием заказа с несколькими способами оплаты, включая Shop Cash и Shop Pay или Рассрочку Shop Pay.
• Сопоставление ERP или OMS для shop_cash.
• Хранение полного значения авторизации Shop Cash.
• Полные и частичные возвраты платежей по заказу.
• Прием действий по выплате shop_cash_refund_debit.
• Сверка выплат по кредитам Shop Cash.
• Поведение предварительных заказов или списания при выполнении, если ваш магазин использует отложенное списание.
• Обработка в приложении для возврата заказов с более чем одним способом оплаты.

При тестировании в рабочей среде используйте заказ на небольшую сумму и следуйте внутренним процедурам вашего магазина для тестовых заказов и возвратов платежей.

Свяжитесь со Службой поддержки Shopify, если вам нужна помощь в любой из следующих ситуаций:

• Проверка доступности Shop Cash для рынка, на котором выполняется поэтапный выпуск.
• Изучение причин неудачного списания или возврата платежа Shop Cash.
• Поиск пропавшей транзакции выплаты Shop Cash, если прошел обычный период выплат плюс еще один цикл.
• Анализ возможности повторной авторизации для аннулированной или просроченной авторизации Shop Cash.
• Планирование запуска для сложного рабочего процесса ERP, OMS, предварительных заказов или выполнения заказов.

Перед масштабированием объема заказов Shop Cash выполните следующие проверки:

• Сопоставление способа оплаты ERP и OMS развернуто и проверено для shop_cash.
• Тестовый заказ Shop Cash принят и прошел весь цикл, включая транзакции авторизации и списания.
• Сверка тестового кредита выплаты Shop Cash с исходным заказом или заказами прошла успешно.
• Тестовый возврат платежа Shop Cash обработан и сверен с дебетом возврата.
• Сгруппированные строки выплат Shop Cash поддерживаются или для них предусмотрен процесс ручной сверки.
• Принципы распределения частичного возврата платежа понятны вашей службе поддержки и финансовому отделу.
• Поведение предварительных заказов, ручного списания и списания при выполнении заказа проверено, если это применимо.
• Приложения для возвратов могут находить нужную транзакцию списания Shop Cash и осуществлять по ней возврат платежа.
• Служба поддержки и финансовый отдел знают разницу между балансом клиента в Shop Cash, предложениями Shop и операциями по счетам в Shop Campaigns.

Требования к API и данным о заказах см. в разделе Данные о заказах Shop Cash и сторонние интеграции. Требования к выплатам см. в разделе Сверка выплат Shop Cash.