Уважаеми партньори,
Поздравяваме Ви с Вашия избор на 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 модули за плащане за:
PHP със секретна дума
Php приложение използващо секретна дума (HMAC-SHA1) - за случаите, в които използването на стандартната интеграция с X.509 сертификати не е възможна или удачна.
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 също следният допълнителен модул:
Генериране на сертификат
Можете да генерирате 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