Skip to content

Getting Started

Description

ePay.bg One Touch is an interface for communication with ePay.bg servers.

Each registered application in ePay.bg receives:

  • secret key (SECRET)
  • a unique identifier (APPID) that you send with each request to our servers

The application enables:

  • making payments from the client's bank cards to the merchant's account opened at ePay.bg
  • availability checks for payment instruments (bank cards, ePay.bg accounts)

Your customers can make payments via the ePay system in the following ways:

  • No user profile in ePay.bg
  • From your user profile in ePay.bg
    • The customer authorizes the connection between the commercial application and his ePay.bg profile
    • The customer specifies a payment account and card with which to make the payment. Users of ePay.bg have an ePay account (Microaccount), as well as the ability to add and use bank credit/debit accounts and cards
    • Payments can be made via an account at https://epay.bg/ or ePay.bg mobile application

Register the application

At this stage, your business needs and the functionality of the application are specified.

1. Liaison with the sales department

After filling out the form "Request to register as a merchant" form, the Commercial Department of ePay.bg will contact you, to register your application.

2. Defining the Reply address

Address of your page to which we send statuses of processed requests.

3. You get APPID + SECRET

Communication with ePay.bg servers

Communication with the servers of ePay.bg is carried out using the JSON REST API.

Entry points for testing purposes

System Address Description
API_BASE https://demo.epay.bg/xdev/api Primary communication address
API_BASE_WEB https://demo.epay.bg/xdev/mobile It is used in the TOKEN generation process

Upon successful request, you receive a response containing:

1
2
3
4
{
    "status": "OK"
    /*and data as requested*/
}

In the case of a failed request, you receive:

1
2
3
4
5
{
    "status": "ERR",
    "err": "SOME_ERROR_CODE",
    "errm": "A message to display to the user"
}

Tokenization

ePay One Touch Hosted Token

We use a form of tokenization hosted by us, through which users securely register their cards.

Concepts
Payment Instruments Payment cards (bank, credit, debit) and accounts
Microaccount A payment instrument that is discovered and supported by EasyPay, via ePay.bg site. Can be used to pay and receive transfers
Communication Interface An electronic circuit designed to a standard that allows one machine to communicate with another machine
Tokenization Data protection mechanism. Implemented to protect financial statements, credit/debit card numbers, personal data, and other confidential information