Данни за поръчки със Shop Cash и интеграции на трети страни

Когато клиент използва Shop Cash за поръчка, Shop Cash се третира като начин на плащане. Това не е отстъпка, подаръчна карта или кредит в магазина. Всяко оставащо салдо по поръчката се заплаща чрез Shop Pay или плащане на вноски в Shopify Pay.

Например, ако клиент използва 25,00 USD в Shop Cash за поръчка на стойност 100,00 USD, тогава поръчката включва плащане със Shop Cash за 25,00 USD и плащане със Shop Pay за 75,00 USD. Вашите данни за поръчката могат да включват повече от един начин на плащане за една и съща поръчка.

Shop Cash се показва като транзакция за поръчка със стойност на портала shop_cash, където са налични стойности на портала. Транзакцията със Shop Cash следва стандартния жизнен цикъл на транзакциите, като упълномощаване, усвояване, анулиране и възстановяване на сума. Shop Cash не използва комбиниран вид транзакция за продажба.

Ако клиентът също използва оферта на Shop от Shop Campaigns, тогава финансираната от кампанията стойност се включва в същата сума на транзакцията за поръчка shop_cash. Частите от салдото на купувача и финансираните от кампанията не се представят като отделни транзакции за поръчка. От януари 2026 г. разходите за кампании се таксуват във Вашата обобщена месечна фактура от Shopify, вместо да се удържат от Вашите изплащания, така че транзакциите за таксуване на кампании в дейността по изплащания се прилагат само за кампании, които са се провели преди тази дата. За повече информация вижте Такси, Shop Campaigns и Shop Cash.

Системите на трети страни, които импортират поръчки, транзакции, плащания, обработки и доставки, възстановявания на суми или връщания, трябва да разпознават Shop Cash като начин на плащане. Ако системата не разпознава Shop Cash, поръчките, които включват Shop Cash, могат да не се импортират успешно, да се импортират с непълни данни за плащане или да изискват ръчно картографиране.

Прегледайте следните изисквания с Вашия доставчик на система от трета страна:

• Системата може да поддържа повече от един начин на плащане за една поръчка.
• Системата може да картографира shop_cash като начин на плащане.
• Системата не третира Shop Cash като отстъпка, подаръчна карта или кредит в магазина.
• Системата съхранява идентификатора на транзакцията за поръчка за всяко упълномощаване, усвояване, анулиране и възстановяване на сума в Shop Cash.
• Системата съхранява пълната стойност за упълномощаване в Shop Cash, без да я съкращава, ако стойността е включена в данните, които системата импортира.
• Системата третира стойностите за упълномощаване като непрозрачни низове и не ги анализира, декодира, нормализира, хешира или извлича смисъл от тях.
• Системата може да обработва възстановявания на суми, които връщат средства както в Shop Pay, така и в Shop Cash.
• Системата може да съгласува транзакциите за изплащания в Shop Cash отделно от транзакциите за плащания с карта.
• Системата не предполага, че транзакциите се връщат в определен ред.

Ако Вашата система от трета страна предполага, че всяка поръчка има само един начин на плащане, свържете се с доставчика, преди да обработвате поръчки със Shop Cash чрез тази система.

Стойността за упълномощаване на транзакция в Shop Cash е непрозрачен низ с променлива дължина. Тя не е кратък код за упълномощаване на карта и не може да бъде прочетена от човек.

Ако Вашата ERP, OMS или друга система от трета страна импортира стойности за упълномощаване в Shop Cash, съхранявайте пълната стойност точно както е предоставена. Използвайте текстово поле с променлива или неограничена дължина, където е възможно.

Когато системата Ви съхранява стойности за упълномощаване в Shop Cash, следвайте тези насоки:

• Не съкращавайте стойността до кратка фиксирана дължина, като например 50 или 100 знака.
• Не анализирайте и не извличайте смисъл от никоя част на стойността.
• Не използвайте стойността за упълномощаване за идентифициране на транзакции за API операции за усвояване, анулиране или възстановяване на суми.

Съкратените стойности за упълномощаване могат да доведат до неуспех при импортиране от трети страни или последваща обработка от ERP и OMS.

За да поддържате усвоявания, анулирания и възстановявания на суми чрез Admin API, съхранявайте идентификаторите на транзакциите за поръчки и връзките с родителските транзакции. Операциите за усвояване и анулиране в Admin API идентифицират транзакцията за упълномощаване с parentTransactionId. Операциите за възстановяване на сума идентифицират транзакцията за усвояване с възможност за възстановяване на сумата чрез parentId.

Когато приложение или интеграция издаде възстановяване на сума в Shop Cash чрез API, възстановяването трябва да е свързано с транзакцията за усвояване в Shop Cash, а не с транзакцията за упълномощаване в Shop Cash. Възстановяванията на суми към транзакцията за упълномощаване се отхвърлят.

Приложенията за възстановяване на суми и манипулаторите на уебкукове трябва да идентифицират транзакцията за усвояване в Shop Cash с възможност за възстановяване на сумата, да изчислят оставащата сума, която може да бъде възстановена за това усвояване, и да създадат възстановяването спрямо идентификатора на транзакцията за усвояване.

Когато използвате Admin API, експортирания на поръчки, експортирания на изплащания или експортирания от приложение на трета страна, третирайте Shop Cash като данни за плащане. В зависимост от експортирането или ресурса на API, който използвате, информацията за Shop Cash може да бъде представена чрез начин на плащане, портал, транзакция на поръчка, транзакция на изплащане и данни за възстановяване на сума.

Когато създавате или актуализирате интеграция, запазвайте следната информация за поръчки, които включват Shop Cash:

• Идентификатор на поръчка и име на поръчка.
• Стойност на начин на плащане или портал, като например shop_cash, когато е налично.
• Идентификатори на транзакции на поръчка за всяка транзакция на плащане.
• Вид и статус на транзакцията, като например оторизиране, усвояване, възстановяване на сума или анулиране.
• Сума и валута на транзакцията.
• Връзки с родителски транзакции, когато са налични.
• Идентификатори на плащания, когато са налични.
• Пълни стойности на оторизиране, ако системата Ви ги импортира.
• Идентификатори на изплащания и идентификатори на транзакции по салдо, когато съгласувате изплащания.
• Идентификатори на транзакции на възстановяване на сума, когато съгласувате връщания.

За подробности относно наличните полета на Admin API, вижте документацията за разработчици за Admin API order transaction. Избягвайте да разчитате на остарели полета, като например OrderTransaction.authorizationCode, за нови интеграции.

Следният опростен пример показва поръчка на стойност 100 USD, платена със 75 USD чрез Shopify Payments и 25 USD чрез Shop Cash. Стойностите са само илюстративни.

{
  "transactions": [
    {
      "kind": "authorization",
      "gateway": "shopify_payments",
      "status": "success",
      "amount": "75.00",
      "currency": "USD",
      "parent_id": null,
      "authorization": "ch_3OabcXYZ..."
    },
    {
      "kind": "authorization",
      "gateway": "shop_cash",
      "status": "success",
      "amount": "25.00",
      "currency": "USD",
      "parent_id": null,
      "authorization": "<long-opaque-variable-length-string>"
    },
    {
      "kind": "capture",
      "gateway": "shop_cash",
      "status": "success",
      "amount": "25.00",
      "currency": "USD",
      "parent_id": "<shop-cash-authorization-transaction-id>",
      "authorization": null
    }
  ]
}

Shop Cash може да изглежда подобно на други стойности за плащане или промоции, но системите Ви трябва да третират всяка стойност поотделно:

Преди да разчитате на система от трета страна за поръчки, които включват Shop Cash, потвърдете следните изисквания:

• Shop Cash е съпоставен като начин на плащане.
• Поръчките с Shop Cash и Shop Pay се импортират с двата начина на плащане.
• Логиката за начина на плащане не предполага по един начин на плащане на поръчка.
• Стойностите на оторизиране се съхраняват като дълги непрозрачни низове и не се отрязват.
• Логиката за възстановяване на суми може да възстанови сумата по правилната транзакция на усвояване.
• Логиката за възстановяване на суми може да върне средства към правилните начини на плащане.
• Съгласуването на изплащанията може да отчита типовете транзакции на кредит, възстановяване на сума и кампания на Shop Cash.
• Работните процеси за обработка и доставка, счетоводство и връщане не третират Shop Cash като отстъпка.

Ако използвате няколко системи, изпълнете този преглед за всяка система, която получава данни за поръчка, транзакция, изплащане, обработка и доставка, възстановяване на сума или връщане.