Smart Checkout на Viva.com Ви позволява да приемате онлайн плащания чрез хоствана страница за плащане.
Това ръководство обяснява основните стъпки за интегриране на Smart Checkout с Вашия уебсайт или приложение — от настройването на Вашия Viva.com акаунт и източника на плащане до пренасочването на клиентите и проверката на резултата от плащането.
1. Изберете Вашата среда на Viva.com
Viva.com предоставя две среди. Уверете се, че използвате средата, която съответства на това, което искате да направите.
Среда | Използвайте я за | Първи стъпки |
Продукционна | Приемане на реални плащания | |
Демо | Тестване на Вашата интеграция и тестови плащания |
Уверете се, че работите в правилната среда, когато настройвате и тествате Вашата интеграция.
2. Създайте източник за онлайн плащания
Източникът на плащане съдържа настройките, които Viva.com използва за плащанията, извършвани чрез Вашия уебсайт или приложение.
Когато настройвате източника на плащане, конфигурирайте Вашия домейн и URL адресите, към които клиентите трябва да бъдат върнати след завършване на процеса на плащане.
Например:
страница за успешно плащане, като „Благодарим Ви за поръчката“
страница за неуспешно плащане, като „Възникна проблем с плащането Ви“
За да създадете източник на плащане за онлайн плащания, отидете на Продажби > Онлайн плащания > Уебсайтове / Приложения/ Apps във Вашето табло за управление на Viva.com.
След като създадете източника на плащане, запазете неговия 4-цифрен код на източника. Този код ще Ви е необходим при конфигурирането на Вашата интеграция.
За подробни инструкции за настройка вижте Източник за онлайн плащания | Viva.com Support.
3. Интегрирайте Smart Checkout
Има три основни стъпки за интегриране на Smart Checkout:
Стъпка 1: Създайте платежна поръчка
Преди да поискате плащане от клиент, създайте платежна поръчка.
На всяка платежна поръчка се присвоява уникален 16-цифрен идентификатор, наречен orderCode.
Създайте платежната поръчка от Вашия сървър чрез Create Payment Order API, след което предайте orderCode към Вашия уебсайт или приложение.
За параметрите на API и подробности за имплементацията посетете Viva.com Developer Portal. В менюто вляво изберете APIs for payments, след това Payment API. Под Payments изберете Create payment order.
Стъпка 2: Пренасочете клиента към Smart Checkout
След като създадете платежната поръчка, пренасочете клиента към Smart Checkout. След това клиентът може да въведе данните си за плащане и да завърши процеса на плащане на страницата на Smart Checkout.
Стъпка 3: Обработете връщането на клиента и проверете резултата от плащането
След процеса на плащане клиентът се пренасочва към URL адреса, конфигуриран за съответния резултат:
Success URL за успешни плащания
Failure URL за неуспешни плащания
Можете да конфигурирате тези URL адреси във Вашето табло за управление на Viva.com под Продажби > Онлайн плащания > Уебсайтове / Приложения/ Apps.
Проверете резултата от плащането
Проверете статуса на трансакцията във Вашата система, като използвате информацията за плащането, върната от Viva.com. Информацията за трансакцията, използвана за валидиране, включва:
AmounttransactionIdstatusId
Viva.com предоставя следните методи за проверка на резултата от плащането.
Webhooks
Webhooks позволяват на Вашата система да получава известия за успешно или неуспешно плащане и поддържат както синхронни, така и асинхронни методи на плащане.
За подробности за имплементацията, параметри на събитията и примерни payload-и посетете Viva.com Developer Portal и изберете Webhooks For Payments от менюто.
Retrieve Transaction API
Можете също да извлечете информация за трансакция чрез Retrieve Transaction API. За параметрите на API и подробности за имплементацията посетете Viva.com Developer Portal. В менюто вляво изберете APIs for payments, след това Payment API. Под Transactions изберете Retrieve transaction.
Допълнителни настройки на Smart Checkout
Можете също да конфигурирате допълнителни настройки на Smart Checkout според нуждите на Вашата интеграция.
Показване на логото на Вашия бранд
Можете да добавите логото на Вашия бранд към Smart Checkout чрез настройките на източника на плащане. За инструкции посетете Viva.com Developer Portal, отидете на Tutorials, изберете Smart Checkout Configuration и след това щракнете върху Add your brand logo.
Уверете се, че качвате ясно лого с подходящ размер за оптимално визуализиране.
Показване на бутон Cancel
Можете да конфигурирате бутон Cancel в разширените настройки на източника на плащане. Това дава на клиентите възможност да отменят поръчката си.
Бутонът Cancel се поддържа за директни интеграции на Smart Checkout и плъгини за Shopify и PrestaShop.
Можете също да конфигурирате webhooks, за да получавате известия за събития, свързани с отмяна на поръчки. Посетете Viva.com Developer Portal, изберете Webhooks For Payments, а след това Order Updated, за да видите повече информация.
Допълнителни опции за плащане
Smart Checkout поддържа и допълнителни конфигурации за плащане, включително:
Периодични плащания: Търговецът инициира автоматично таксувания по предварително определен график след първото плащане.
Предварителни оторизации: Сума се резервира, а прехвърлянето на средствата се инициира по-късно.
За технически подробности по имплементацията и други налични конфигурации на Smart Checkout посетете Viva.com developer portal.
Все още имате нужда от помощ? Нашият екип е тук, за да Ви съдейства. Моля, свържете се с нас чрез опцията Пишете си с нас във Вашия Viva.com account.