Change the expiration time of 10-digit codes

General information

• Client - The end user of the service
• Merchant - A legal entity that has concluded a contract with ePay.bg
• The files cited in the documentation can be downloaded from the "Demo package" link under the login button at https://demo.epay.bg/

Process description

The request serves to extend the expiration time of an already existing 10-digit code or invalidate it.

1. A merchant wants to extend the expiration time of a 10-digit code he has provided to a customer.
2. The merchant sends an HTTP GET request to the given URL.
3. Receives a response from ePay.bg about successfully changing the expiration time of the 10-digit code or an error with a description of the problem.

Communication scheme

Production environment

Method	WEB_ADDRESS
GET	https://www.epay.bg/v3main

Demo environment

Method	WEB_ADDRESS
GET	https://demo.epay.bg/xdev/web

Request to change the expiration time

Method	Address
GET	WEB_ADDRESS/paylogin/request/update

Parameter	Type	Description	Optionality
ENCODED	string	Base64-encoded (RFC 3548) payment request, EOL=''.	Mandatory
CHECKSUM	string	Checksum on ENCODED, generated as HMAC with SHA-1 algorithm and the merchant's secret word.	Mandatory

Parameters in ENCODED

Parameter	Type	Description	Optionality
MIN	int	Customer Identification Number (CIN)	Mandatory
INVOICE	int	Invoice Number; unique to merchant	Mandatory
EXP_TIME	datetime	Payment End Date/Time; format DD.MM.YYYY[hh:mm[:ss]]	Mandatory

Info

In case an EXP_TIME greater than 30 days from the moment of execution of the current request is submitted, EXP_TIME = now + 30 days is automatically set.

Example code for making the request

PerlPHP

{
    # Encoding the request
    $ENCODED  = encode_base64('DATA', ''); # '' за EOL (def. е "\n")

    # Generate checksum
    $CHECKSUM = hmac_hex($ENCODED, $secret, \&sha1);
}

{
    # Encoding the request
    $ENCODED  = base64_encode('DATA');

    # Generate checksum
    $CHECKSUM = hmac('sha1', $ENCODED, $secret);

    #  hmac function code can be seen in demo.php
}

Response

OKERR

SYS_CODE=OK

ERR=Error description

Code invalidation

For a 10-digit code invalidation, past time must be submitted in the EXP_TIME parameter.