8 мин. четенеПуснат август 2026 г.

Право в checkout: Shopify Payments App за Paypercut

  • Разработка на публично приложение
  • Shopify Payments App
  • Финтех

Всяко Shopify приложение може да промени онлайн магазина. Много малко имат право да докоснат стъпката на плащане. Изградихме приложение за плащания (Payments App) за Paypercut, преминахме с него през прегледа на Shopify за платежни приложения и го пуснахме в Shopify App Store.

30
държави от ЕИП, в които купувачите виждат Paypercut при плащане
5
платежни операции: продажба, авторизация, усвояване, анулиране и възстановяване
15
грешки при настройката, всяка с конкретно съобщение и следваща стъпка
0
уебхука, които търговецът трябва да настрои ръчно
Клиент
Paypercut, София
Платформа
Shopify Payments App
Работата
Публично приложение, преглед за плащания, пускане
На живо
10 август 2026 г., Shopify App Store

Най-строго охраняваният екран в Shopify

Paypercut е европейска платежна платформа, създадена в София. Тя дава на търговците едно плащане за карти, дигитални портфейли и няколко доставчици на „купи сега, плати по-късно“, с изплащане в местна валута по банковата сметка, която вече имат. Посланието им е простичко: продавайте в цяла Европа, без да преправяте плащането за всеки пазар.

За много европейски търговци „вашето плащане“ означава Shopify. Затова Paypercut трябваше да се появи там, където е най-важно: в списъка с методи за плащане в самия checkout на Shopify, до всички останали начини за плащане.

Това е по-трудно, отколкото звучи. Shopify не позволява на доставчиците на плащания да вграждат скриптове в плащането. Доставчикът трябва да стане Shopify Payments Partner, да изгради отделно приложение за плащания върху Payments Apps API на Shopify, да мине преглед, който е много по-строг от обичайния преглед в App Store, и след това да работи с реални пари без никакво място за изгубена или двойно таксувана поръчка.

Нашата задача беше да изградим това приложение за Paypercut. Търговецът трябва да може да го инсталира, да постави ключ и веднага да направи тестово плащане. Купувачът трябва да мине от плащането в Shopify към Paypercut и обратно, без да усети прехода. А всяко плащане, усвояване, анулиране и възстановяване трябва да стига до правилния статус и в двете системи, всеки път.

Ето как го изградихме, минахме през прегледа на Shopify и го пуснахме в Shopify App Store.

Част 1: пътят на купувача, до Paypercut и обратно

Напускането на плащането изглежда рисковано

Paypercut приема данните на картата на собствена хоствана страница, така че те изобщо не минават през Shopify и през търговеца. Уловката е в прехвърлянето. Всяко пренасочване далеч от плащането е момент, в който купувачите се колебаят, а всеки проблем по обратния път може да остави поръчка платена, но непотвърдена.

Offsite payments extension с чист път натам и обратно

Изградихме Paypercut като offsite payments extension. При плащане купувачите в 30 държави от ЕИП виждат „Плащане с карта“ с логата на Visa и Mastercard, направо в стандартния списък с методи за плащане на Shopify. Демото в горната част на страницата показва целия път.

  1. 01ПрехвърлянетоКогато купувачът натисне „Плати сега“, Shopify извиква нашето приложение, а то създава хоствана сесия за плащане в Paypercut точно за това плащане. Имейлът и езикът на купувача се предават, така че страницата на Paypercut се отваря с попълнени данни и на неговия език.
  2. 02ПлащанетоКупувачът въвежда картата си на страницата на Paypercut, с 3-D Secure, когато банката го изисква.
  3. 03ВръщанетоPaypercut връща купувача към нашето приложение, което потвърждава плащането и казва на Shopify да завърши поръчката. Купувачът стига до собствената страница за благодарност на Shopify.

Психологията: пренос на доверие. Купувачът започва в плащане, на което вече има доверие, избира метод, който изглежда вграден, и завършва на страницата за потвърждение на същото плащане. Стъпката в Paypercut е между два познати екрана, така че доверието се пренася и върху нея.

Част 2: пътят на търговеца, от инсталацията до първото тестово плащане

Настройката на плащанията е мястото, където търговците се отказват

Повечето платежни интеграции карат търговците да копират ключове, да настройват уебхукове и да превключват настройки в две различни табла. Всяка допълнителна стъпка е шанс да поставят грешното нещо и да се откажат.

Повечето платежни интеграции
  • Копиране на ключове между две табла
  • Ръчна настройка на уебхукове
  • Превключване на настройки на две места
  • Всяка допълнителна стъпка е шанс да поставите грешното нещо и да се откажете
Приложението на Paypercut
  • Тестов и реален ключ един до друг, на една страница
  • Грешки, които казват какво се е объркало и какво да направите
  • Банер за статуса, който обяснява какво липсва
  • Никаква настройка на уебхукове

Два ключа, ясни грешки, без настройка на уебхукове

Цялата настройка на търговеца става на една страница:

  • Тестов и реален ключ, един до друг. Търговците могат да започнат с тестов (sandbox) ключ, докато Paypercut проверява бизнеса им, и да добавят реалния ключ по-късно. Тестовият режим на самия Shopify решава кой от двата ключа се използва за всяко плащане, така че търговците тестват точно както Shopify ги учи.
  • Грешки, които казват какво да направите. Написахме конкретно съобщение за всяка грешка, която можехме да предвидим, общо 15: поставен публичен (publishable) ключ вместо таен, реален ключ в полето за тестовия, изтекъл ключ или ключ без права за плащания. Всяко съобщение казва на търговеца какво се е объркало и води към точното място в таблото на Paypercut.
  • Банер за статуса, който обяснява какво липсва. Ако има само тестов ключ, страницата казва, че реалните плащания ще бъдат отказвани, докато не се добави реалният ключ. Ако има само реален ключ, казва, че плащанията в тестов режим няма да минават.
  • Без настройка на уебхукове. Когато ключът бъде запазен, приложението само регистрира във фона своя уебхук адрес в Paypercut за съответния режим.
Страницата за настройка. Публичният ключ е хванат с конкретно съобщение, тестовият и реалният таен ключ са запазени и маскирани, а търговецът стига до настройките на Paypercut в Shopify.

Психологията: разпознаване вместо припомняне. Търговецът не трябва да помни кой ключ какъв е. Полетата казват „Започва с sk_test_“ и „Започва с sk_live_“, а грешката назовава точно ключа, който е поставил.

Част 3: машинното отделение, парите да са точни

Две системи трябва да са съгласни за всеки цент

Shopify и Paypercut пазят всеки свой запис за плащането. Мрежите губят заявки, купувачите затварят раздели, а Shopify повтаря заявките, за които не е сигурен. Приложението трябва да поддържа двата записа в синхрон, без никога да таксува два пъти и без да оставя поръчка блокирана.

Идемпотентни сесии и два начина за потвърждение

Една сесия за плащане от началото до края, а после възстановяване на сума няколко дни по-късно. Пътят през уебхука върви паралелно като резервно потвърждение.
  • Една сесия в Shopify, една сесия в Paypercut. Идентификаторът на сесията в Shopify е ключът за идемпотентност за плащането в Paypercut. Ако Shopify попита два пъти, Paypercut отговаря със същата сесия, вместо да създаде втора.
  • Потвърждаваме два пъти, приключваме веднъж. Когато купувачът се върне, приложението пита Paypercut за статуса на плащането и опитва отново, докато то още чака. Паралелно Paypercut изпраща подписан уебхук. Всеки уебхук се проверява, дедуплицира и поема атомарно, така че потвърждението, което пристигне първо, приключва плащането, а второто не променя нищо.
  • Усвояване, анулиране и възстановяване от админ панела на Shopify. Всяка от петте операции има собствена машина на състоянията (необработена, в обработка, обработена), така че повторена заявка за възстановяване никога не може да върне парите два пъти. Търговците могат и само да авторизират плащането и да усвоят сумата по-късно; приложението предава на Shopify срока на авторизацията в Paypercut, така че в поръчката се вижда кога изтича блокирането на сумата.
  • Mutual TLS на платежните адреси. Shopify представя клиентски сертификат при всяка платежна заявка като само тези адреси са поставени зад проверка на сертификата.
За търговеца това е просто Shopify. Авторизирана поръчка се усвоява, после се възстановява, и двете действия се появяват в хронологията на поръчката.

Част 4: през прегледа и в реална работа

Прегледът на Shopify за платежни приложения

Платежните приложения минават през отделен преглед и той е подробен. Обратната връзка, по която работихме, включваше изтриване на данните за достъп на търговеца при деинсталиране, връщане на търговеца директно към настройките на Paypercut в Shopify, след като запази ключовете си, и толкова ясни съобщения за грешка, че по всяко от тях да може да се действа. След повторното подаване Paypercut излезе на живо в Shopify App Store на 10 август 2026 г.

Изградено да работи в платежна компания

Paypercut е регулиран платежен бизнес, затова приложението трябваше да пасне на тяхната платформа, а не обратното. Работихме рамо до рамо с инженерите на Paypercut, които управляват Kubernetes инфраструктурата, на която работи приложението.

  • Процес за издаване: сливанията се разгръщат в dev среда, а маркираните версии минават през staging към продукция. Shopify разширението се издава чрез собствен работен поток от същия таг.
  • Подсилена сигурност: грешките от платежния шлюз се записват в логове и никога не се показват на купувачите. Формата за ключове дава един и същ отговор за невалиден ключ и за ключ на друг магазин, така че не може да се използва за налучкване на ключове. Контейнерните образи се сканират и поправят преди всяко издаване.
  • Най-новите правила на Shopify: когато Shopify въведе изтичащи офлайн токени за достъп, приложението премина към подновяване на токените преди изтичането им, така че нито една платежна заявка не пропада заради остарял токен.

Нов метод за плащане, вграден в Shopify

Paypercut искаше европейските търговци в Shopify да го добавят така, както добавят всеки друг доставчик на плащания. Сега точно така работи.

  • Вграден в плащането, в 30 държави от ЕИП„Плащане с карта“ стои в собствения списък с методи за плащане на Shopify, а пътят до хостваната страница на Paypercut и обратно почти не се усеща от купувачите.
  • Самостоятелна настройкаТърговците поставят ключ и правят тестови плащания без разговор, без разработчик и без настройка на уебхукове.
  • Всяка операция точно веднъжПродажбите, авторизациите, усвояванията, анулиранията и възстановяванията остават в синхрон между Shopify и Paypercut, дори когато заявките се повтарят.
  • Одобрено и на живоPaypercut мина прегледа на Shopify за платежни приложения и е публикуван в Shopify App Store.

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

Как е изградено
  • Shopify Payments App
  • Payments Apps API
  • Offsite payments extension
  • Node
  • Remix
  • Админ панел с Polaris
  • Mutual TLS
  • Подписани, дедуплицирани уебхукове
  • Машини на състоянията за всяка операция
  • Kubernetes
  • Dev, staging, продукция
Следваща стъпка

Искате такава работа и за вашия магазин?

Изпратете ни URL адреса и какво го забавя. Разглеждаме магазина, преди да отговорим.