Уважаеми партньори,

Поздравяваме Ви с Вашия избор на eBG.bg като платформа за електронни разплащания. Тази страница ще Ви помогне с процеса на интеграция с eBG.bg. Тук ще намерите описание на процеса на извършване на плащане чрез eBG.bg, примерни Php, Python, Java и .Net приложения реализиращи интерфейса на търговски обекти, както и всички необходими ресурси.

Интеграционният пакет можете да изтеглите от http://www.ebg.bg/dev/merchantInterface.zip или от http://demo.ebg.bg/dev/merchantInterface.zip.

За повече информация разгледайте описанието на процеса на плащане.

За повече информация и съдействие относно интеграцията моля свържете се с нас.

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

Изтеглете лого на eBG.bg от тук.

PHP

Php приложението е достъпно в следните версии:

модул за Php 5 на български език
модул за Php 5 на английски език
модул за Php 4 на български език (тествано с Php 4.3 и Php 4.4)

и изисква:

openssl -- за генерирането на PKCS#7 структура съдържаща подписа на търговския обект на съобщенията
curl -- за HTTP POST заявки към eBG.bg (незадължително, ако е включена опцията allow_url_fopen)
simplexml -- xml parser - за обработка на отговорите от страна на eBG.bg - по-подразбиране включен в PHP 5 (за PHP 4 се използва simplexml44).

От тук можете да изтеглите eBG.bg модули за плащане за:

RexCart – Безплатно решение за електронен магазин, базирано на OpenCart, с вграден модул за разплащания през eBG.bg. Безплатния модул можете да изтеглите от ТУК.

За интеграция за плащания чрез eBG.bg на Magento базиран онлайн магазин можете да се обърнете към уеб агенция ProDesign (e-mail: office@prodesign.bg, тел. 02 / 831 0868).

PHP със секретна дума

Php приложение използващо секретна дума (HMAC-SHA1), за случаите, в които използването на стандартната интеграция с X.509 сертификати не е възможна или удачна:

модул с HTTP(S) POST интеграция - иницииране на плащане чрез браузер на клиента; възможност нотификация при извършено или отказано плащане
модул с XML/HTTP(S) интеграция - иницииране на плащане чрез комуникация между сървъра на търговеца и eBG.bg; възможност за нотификация при промяна на статуса на плащане; възможност за проверка на статуса на плащане инициирана от сървъра на търговеца

Python

Python модулът изисква Python 2.4+ и е успешно тестван с Python 2.5. Необходим е следният допълнителен софтуер:

M2Crypto -- за генерирането на PKCS#7 структура съдържаща подписа на търговския обект на съобщенията
тествано с 0.17 - работи, с 0.18 - проблеми при работа под Apache уеб сървър

Приложено е примерно приложение на Django.

JAVA

Java приложението изисква Servlet 2.3 или Servlet 2.4 уеб сървър. Необходими са също:

Bouncy Castle crypto provider -- за генерирането на PKCS#7 структура съдържаща подписа на търговския обект на съобщението
Commons Http client -- за HTTP POST заявки към eBG.bg

.NЕТ

.Net библиотеката изисква Microsoft .NET Framework 1.1 или Microsoft .NET Framework 2.0. Необходим e също следният допълнителен модул:

CAPICOM -- за генерирането на PKCS#7 структура съдържаща подписа на търговския обект на съобщението

Генериране на сертификат

Можете да генерирате self-signed X.509 сертификат използвайки openssl:
openssl req -outform PEM -out merchant_ebg.cer -keyform PEM -keyout merchant_ebg.key -newkey rsa:1024 -sha1 -new -x509 -days 3650 -set_serial 10

Въвежданите данни за subject name са без значение за eBG.bg, eBG.bg използва единствено публичния ключ от сертификата:
Country Name (2 letter code) [AU]:BG
State or Province Name (full name) [Some-State]:Bulgaria
Locality Name (eg, city) []:Sofia
Organization Name (eg, company) [Internet Widgits Pty Ltd]:Sample merchant
Organizational Unit Name (eg, section) []:IT
Common Name (eg, YOUR name) []:78654321
Email Address []:

Можете да конвертирате сертификата и частния ключ до pkcs12 (pfx) формат ако е необходимо:
openssl pkcs12 -export -inkey merchant_ebg.key -in merchant_ebg.cer -out merchant_ebg.pfx