Промяна на изтичащото време на 10-цифрен код

Обща информация

• Клиент - Краен потребител на услугата
• Търговец - Юридическо лице, сключило договор с ePay.bg
• Файловете, които се цитират в документацията, може да се свалят от линка "Демо пакет" под бутона за вход на https://demo.epay.bg/

Описание на процеса

Заявката служи за удължаване на изтичащото време на вече съществуващ 10-цифрен код или неговото инвалидиране.

1. Търговецът желае да удължи изтичащото време на 10-цифрен код, който е предоставил на клиент.
2. Търговецът изпраща HTTP GET заявка на даденото URL.
3. В същата HTTP сесия, ePay.bg ще върне на търговеца "Системен код", което е знак за успешно извършена промяна на изтичащото време на 10-цифрения код.

Комуникационна схема

Продукционна среда

Метод	WEB_ADDRESS
GET	https://www.epay.bg/v3main

Демо среда

Метод	WEB_ADDRESS
GET	https://demo.epay.bg/xdev/web

Заявка за промяна на изтичащо време

Метод	Адрес
GET	WEB_ADDRESS/paylogin/request/update

Параметър	Тип	Описание	Опционалност
ENCODED	string	Кодирана с base64 (RFC 3548) заявка за плащане, EOL=''.	Задължителен
CHECKSUM	string	Контролна сума върху ENCODED, генерирана като HMAC с алгоритъм SHA-1 и секретната дума на търговеца.	Задължителен

Параметри в ENCODED

Параметър	Тип	Описание	Опционалност
MIN	int	Клиентски идентификационен номер (КИН)	Задължителен
INVOICE	int	Номер на фактура; уникален за търговеца	Задължителен
EXP_TIME	datetime	Крайна дата/час за плащане; формат DD.MM.YYYY[hh:mm[:ss]]	Задължителен

Инфо

В случай че е подаден EXP_TIME по-голям от 30 дни от момента на изпълнение на текущата заявка, автоматично се слага EXP_TIME = сега + 30 дни.

Примерен код за изготвяне на заявката

PerlPHP

{
    # Кодиране на заявката
    $ENCODED  = encode_base64('DATA', ''); # '' за EOL (def. е "\n")

    # Генериране на контролна сума
    $CHECKSUM = hmac_hex($ENCODED, $secret, \&sha1);
}

{
    # Кодиране на заявката
    $ENCODED  = base64_encode('DATA');

    # Генериране на контролна сума
    $CHECKSUM = hmac('sha1', $ENCODED, $secret);
    # кода на функцията hmac може да видите в demo.php
}

Oтговор

OKERR

SYS_CODE=OK

ERR=Описание на грешка

Инвалидация на кода

За инвалидация на 10-цифрен код трябва да се подаде време в миналото в
параметъра EXP_TIME.