i3 Cpay Payment Gateway for WooCommerce — Безбедно плаќање преку Cpay (CaSys) за WooCommerce

Што прави овој плагин?

I3 Cpay Payment Gateway for WooCommerce е WooCommerce плагин кој го додава Cpay (платежниот gateway на македонскиот провајдер CaSys/Касис) како начин на плаќање при наплата. Купувачот плаќа на hosted страницата на Cpay; плагинот го управува пренасочувањето, го потпишува барањето со SHA-256 и го валидира одговорот пред нарачката да се означи како платена.

Главни можности:

• Cpay како начин на плаќање — се прикажува при checkout заедно со другите WooCommerce gateway-и
• SHA-256 HMAC шифрирање — секое барање и враќање се потпишува и проверува со вашиот таен клуч
• Автоматско пренасочување — по нарачката, купувачот оди на Cpay без дополнителни кликови (може да се исклучи)
• Јазик на платежната страница — македонски, англиски, бугарски или албански на формата на Cpay
• Конверзија на валута — ако продавницата користи друга валута (на пр. EUR), курсот ја претвора сумата во MKD за Cpay (заокружена нагоре)
• Класичен и Blocks checkout — работи со стандардниот WooCommerce checkout и Checkout Block
• Обработка на неуспешно плаќање — при неуспех или откажување, купувачот се враќа на checkout со порака за грешка

Плагинот не поддржува автоматски рефундирања преку gateway-от; рефундирањата се прават рачно преку Cpay или банката.

Како се администрира плагинот

1. Најдете ја страницата за поставки

По активирање на плагинот, отворете го административниот панел на WordPress и одете на:

WooCommerce → Подесувања → Плаќања → Cpay начин на плаќање

(Кликнете Управувај до името на gateway-от.)

2. Вклучете го gateway-от

Штиклирајте го Enable Cpay Payment Gateway (Вклучи Cpay начин на плаќање). Ако ова остане нештиклирано, Cpay нема да се прикажува при checkout.

3. Конфигурирајте го gateway-от

Поставка	Што прави
Title (Наслов)	Името што го гледа купувачот при checkout. Стандардно: Cpay плаќање.
Description (Опис)	Краток текст под начинот на плаќање. Стандардно: Платете безбедно преку Cpay.
Merchant Name (Име на трговец)	Името на трговецот, како што ви го дава Cpay/CaSys.
Merchant Code (Код на трговец)	Кодот на трговецот, како што ви го дава Cpay/CaSys.
Secret Key (SHA-256) (Таен клуч)	SHA-256 таен клуч од Cpay, за потпишување и проверка. За тестирање користете TEST_PASS.
Payment Page Language (Јазик на платежната страница)	Јазик на Cpay формата: македонски (mk-MK), англиски (en-US), бугарски (bg-BG) или албански (sq-AL). Стандардно: македонски.
Exchange Rate (MKD) (Курс на размена)	Множител за претворање на сумата во MKD кога валутата на продавницата не е MKD. Користете 1 ако цените се во MKD. Пример: 61.5 ако продавницата е во EUR.
Auto Redirect to Cpay (Автоматско пренасочување)	Кога е вклучено, купувачот автоматски оди на Cpay по checkout. Кога е исклучено, на receipt страницата се прикажува копче Pay Now. Стандардно: вклучено.
Simple mode form for Cpay (Едноставен режим)	Кога е вклучено, се користи поедноставен Cpay form (isSimple). Стандардно: вклучено.

4. Добијте ги Cpay credentials

Контактирајте го Cpay/CaSys support или вашиот банкарски процесор за Merchant Name, Merchant Code и Secret Key (SHA-256). TEST_PASS користете го само за тест трансакции.

5. Зачувајте ги промените

Кликнете Save changes на дното на страницата. Gateway-от е достапен веднаш по вклучување и зачувување на credentials.

6. Исклучување на gateway-от

Одштиклирајте Enable Cpay Payment Gateway и зачувајте — Cpay нема да се прикажува при checkout, нема потреба од деинсталација на плагинот.

Како функционира за купувачите

1. Купувачот го избира Cpay Payment при checkout и ја завршува нарачката.
2. WooCommerce ја креира нарачката и го пренасочува купувачот кон чекорот за Cpay плаќање.
3. Плагинот гради потпишана платежна форма (сума, податоци за наплата, return URL-и) и автоматски ја праќа на vpos.cpay.com.mk.
4. Купувачот ги внесува податоците за картичка на hosted страницата на Cpay на јазикот што сте го поставиле.
5. При успешно плаќање, Cpay го враќа купувачот на вашиот сајт; плагинот проверува SHA-256 checksums и ја означува нарачката како платена. Купувачот оди на страницата за потврда.
6. При неуспешно или откажано плаќање, купувачот се враќа на checkout со порака за грешка и може повторно да проба.
7. Ако Auto Redirect е исклучено, купувачот гледа копче Pay Now на receipt страницата и мора да кликне за да оди на Cpay.

Забелешки

• Потребен е WooCommerce — плагинот не се активира без WooCommerce.
• HPOS компатибилен — работи со WooCommerce High-Performance Order Storage (custom order tables).
• Сумата до Cpay секогаш е во MKD; користете курс ако продавницата прикажува друга валута.
• Безбедност — податоците од Cpay се валидираат со четири checksum проверки пред промена на статусот.
• Без автоматско рефундирање — рефундирањата се прават рачно преку Cpay или процесорот.
• Подготвен за превод — плагинот доаѓа со изворен текст на англиски и преводи на македонски, бугарски и албански преку папката languages.