Към съдържанието

Преди да започнете

Описание

ePay.bg One Touch e интерфейс за комуникация със сървърите на ePay.bg.

Всяко регистрирано приложение в ePay.bg получава:

  • таен ключ (SECRET)
  • уникален идентификатор (APPID), който изпращате с всяка заявка към сървърите ни

Приложението дава възможност за:

  • извършване на плащания от банкови карти на клиента към сметка на търговеца, открита при ePay.bg
  • справки за наличност по платежни инструменти (банкови карти, сметки в ePay.bg)

Вашите клиенти могат да извършват плащания през системата на ePay по следните начини:

  • Без наличие на потребителски профил в ePay.bg
  • От потребителския си профил в ePay.bg
    • Клиентът оторизира връзката между търговското приложение и профила си в ePay.bg
    • Клиентът посочва разплащателна сметка и карта, с които да бъде извършено плащането.
      Потребителите на ePay.bg разполагат с ePay сметка (Микросметка), както и с възможност за добавяне и използване на банкови кредитни/дебитни сметки и карти
    • Плащанията могат да бъдат извършвани през профил в https://epay.bg/ или мобилно приложение ePay.bg

Регистриране на приложението

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

1. Връзка с търговски отдел

След попълване на формата "Заявка за регистриране като търговец", Търговския отдел на Ипей АД ще се свърже с Вас, за да регистрирате приложението си.

2. Дефиниране на Reply address

Aдрес на страницата ви, на който изпращаме статуси на обработените заявки.

3. Получаватe APPID + SECRET

Комуникация със сървърите на ePay.bg

Комуникацията със сървърите на ePay.bg се извършва посредством JSON REST API.

Входни точки за тестови цели

Система Адрес Описание
API_BASE https://demo.epay.bg/xdev/api Основен адрес за комуникация
API_BASE_WEB https://demo.epay.bg/xdev/mobile Използва се в процеса на генериране на TOKEN

При успешна заявка получавате отговор, съдържащ:

1
2
3
4
{
    "status": "OK" 
    /*и данни според заявката*/
}

При неуспешна заявка получавате:

1
2
3
4
5
{
    "status" : "ERR", 
    "err" : "SOME_ERROR_CODE", 
    "errm" : "Съобщение, което може да покажете на потребителя"
}

Токенизация

ePay One Touch Hosted Token

Използваме хостната при нас форма на токенизация, чрез която потребителите регистрират сигурно картите си.

Понятия

Платежни инструменти Платежни карти (банкови, кредитни, дебитни) и сметки
Микросметка Платежен инструмент, който се открива и поддържа от EasyPay, чрез сайта ePay.bg. Може да се ползва за плащане и получаване на преводи
Комуникационен интерфейс Електронна схема, проектирана по стандарт, която позволява една машина да комуникира с друга машина
Токенизация Механизъм за защита на данните. Прилага се, за да се защитят финансови отчети, номера на кредитни/дебитни карти, лични данни и други поверителни информации