API. Integration

MFIs: https://api.vepay.online/mfo
Merchant/widget: https://api.vepay.online/merchant

Request server: https://api.vepay.online/; test request server: https://test.vepay.online

Data is sent in the POST request body in the JSON format and the UTF-8 encoding.
MFI/Merchant identifier and key are given after registration in the system.
Authorisation parameters are contained in the request header:
X-Mfo (for MFI API) X-Login (Crowdfunding API and Merchant API) int MFI/Merchant identifier
X-Token string Authorisation token
Token algorithm:
SHA1(SHA1(key) + SHA1 (request body)), where SHA1 produces a 40-symbol line with a hexadecimal hash value.

If the request is successfully handled, an HTTP 200 code will be returned. In the event of an authorisation error, an HTTP 401 Unauthorized code will be returned. In the event of other errors, a 500 Internal Server Error or another relevant code will be returned.

Also, the following JSON-formatted fields are returned in the request body:
Parameter Description Example
name HTTP error description Unauthorized
message Additional error message
code Error 0
status HTTP error code 401
Example of code, API integration<?php
$data = json_encode(["id" => 123]);
$login="123";
$key="12345456780";
$token=sha1(sha1($key).sha1($data));
$link = "https://api.vepay.online/mfo/out/state";

$curl=curl_init();
curl_setopt($curl,CURLOPT_RETURNTRANSFER,true);
curl_setopt($curl,CURLOPT_POSTFIELDS,$data);
curl_setopt($curl,CURLOPT_CUSTOMREQUEST,'POST');
curl_setopt($curl,CURLOPT_URL,$link);
curl_setopt($curl,CURLOPT_HEADER,false);
curl_setopt($curl,CURLOPT_HTTPHEADER, [
'Content-type: application/json',
'Accept: application/json',
'X-Mfo: '.$login,
'X-Token: '.$token
]);
curl_setopt($curl,CURLOPT_SSL_VERIFYPEER,0);
curl_setopt($curl,CURLOPT_SSL_VERIFYHOST,0);

$out=curl_exec($curl);
curl_close($curl);

$Response=json_decode($out,true);
print_r($Response);
Example of payment for services via the Merchant API1. Payment: a payment request is sent via the API./merchant/pay
{
"amount": 100,
"extid": "4",
"descript": "Order 4"
}

Response:
{
"status": 1,
"id": 11022,
"url": "https://test.vepay.online/pay/form/11022",
"message": ""
}
2. The user is redirected to the payment page (through the URL contained in the response).TODO 3. If the status is not sent in the return request, the status must be verified:/merchant/state
{
"id": 11022
}

Response:
{
"status": 1,
"message": "Успешно"
}
В коде ответа может присутствовать параметр RC (response code). Справочник по rc-кодам:
Код Значение Действие Описание VISA MC Мир
00 Successful approval/completion or V.I.P. PIN verification is successful Approved Операция одобрена + + +
01 Refer to card issuer Decline Связаться с банком, выпустившим карту + +
02 Refer to card issuer, special condition Decline Связаться с банком, выпустившим карту. Возможны особые условия. +
03 Invalid merchant or service provider Decline Неверно указан мерчант или сервис + + +
04 Pick up card Decline Изъятие карты + + +
05 Do not honor Decline Не оплачивается + + +
06 Error Decline Ошибка транзакции +
07 Pick up card, special condition (other than lost/stolen card) Decline Изъятие карты, при иных условиях, чем потеря карты или украденная карта. +
08 Honor with ID Approved Одобрение операции +
10 Partial approval Approved Частичное одобрение + +
11 V.I.P. approval Approved Если генерируется, то заменяется для возвращения на код 00 по причине соблюдения безопасности. +
12 Invalid transaction Decline Неверная транзакция + + +
13 Invalid amount (currency conversion field overflow); or amount exceeds maximum for card program Decline Отклоняется, т.к. недостаточно средств на счете. + + +
14 Invalid account number (no such number) Decline Неправильный номер счета +
14 Invalid card number Decline Неправильный номер карты + +
15 No such issuer Decline Неизвестный банк, выпустивший карту. + + +
19 Re-enter transaction Decline Повторная транзакция +
21 No action taken (unable to back out prior transaction) Decline Транзакция не проводится, нет данных для ее отката. +
25 Unable to locate record in file, or account number is missing from the inquiry Decline Не найдены данные в базе или неправильный номер счета в запросе. +
28 File is temporarily unavailable Decline Данные временно недоступны +
30 Format error Decline Неправильный формат запроса. Операция отклонена + +
39 No credit account Decline Ненадежный счет +
41 Pick up card (lost card) Decline Изъятие карты, карта числится утерянной. + + +
43 Pick up card (stolen card) Decline Изъятие карты, карта числится украденной. + + +
51 Insufficient funds Decline Недостаточно средств + + +
52 No checking account Decline Нет текущего счета +
53 No savings account Decline Нет сберегательного счета +
54 Expired card Decline Закончился срок действия карты + + +
55 Incorrect PIN Decline Неверный PIN + + +
57 Transaction not permitted to cardholder Decline Операция не разрешена владельцу карты + + +
58 Transaction not allowed at terminal Decline Транзакция на терминале запрещена + + +
59 Suspected fraud Decline Подозревается мошенничество +
61 Activity amount limit exceeded Decline Превышено число попыток. Данный код может использоваться для переадресации, + +
62 Restricted card (for instance, in Country Exclusion table) Decline Запрет на карту + + +
63 Security violation Decline Нарушение правил безопасности + + +
64 Transaction does not fulfill AML requirement Decline Транзакция не удовлетворяет правилам контроля за "отмыванием" денег +
65 Activity count limit exceeded Decline Превышен лимит количества действий + +
70 Contact Card Issuer Decline Требуется контакт с банком - эквайером +
71 PIN Not Changed Decline PIN не изменен. Операция отклонена +
75 Allowable number of PIN-entry tries exceeded Decline Превышено допустимое количество попыток ввода PIN- кода + + +
76 Unable to locate previous message (no match on retrieval reference number) Decline Невозможно найти предыдущее сообщение (нет совпадений по поисковому номеру) +
76 Invalid/nonexistent “To Account” specified Decline Операция отклонена +
77 Previous message located for a repeat or reversal, but repeat or reversal data inconsistent with original message Decline Предыдущее сообщение находится в состоянии повторения или отмены,но повторение или отмена, несовместимых с текущим сообщением +
77 Invalid/nonexistent “From Account” specified Decline Операция отклонена +
78 “Blocked, first used”—Transaction from new cardholder, and card not properly unblocked Decline Карта была заблокирована и не разблокирована нормально. +
78 Invalid/nonexistent account specified (general) Decline Операция отклонена +
78 Invalid/nonexistent account specified Decline Введен неправильный/ несуществующий счет +
79 Transaction reversed Decline Транзакция отменена +
80 Visa transactions: credit issuer unavailable.Private label: invalid date Decline Операции VISA: кредитный эмитент недоступен. Примечание: недействительная дата +
81 PIN cryptographic error found (error found by VIC security module during PIN decryption) Decline Обнаружена криптографическая ошибка PIN (ошибка найдена модулем безопасности VIC при расшифровке PIN-кода) +
81 Domestic Debit Transaction Not Allowed (Regional use only) Decline Операция отклонена +
82 Negative Online CAM, dCVV, iCVV, or CVV results Or Offline PIN authentication interrupted Decline Отрицательные результаты online проверок CAM, dCVV, iCVV или CVV или автономная аутентификация PIN прервана +
84 Invalid Authorization Life Cycle Decline Неправильный процесс авторизации. Операция отклонена +
85 No reason to decline request for account number verification, address verification, CVV2 verification, or credit voucher or merchandise return + Нет причин отклонять запрос на проверку номера счета, проверка адреса, CVV2 подтверждение или кредитный ваучер или возврату товара. + +
86 Cannot verify PIN Decline Невозможно проверить PIN + + +
87 Purchase Amount Only, No Cash Back Allowed Approved Только покупки, кэшбек запрещен. +
88 Cryptographic failure Decline Проблема декодирования. Операция отклонена + +
89 Unacceptable PIN— Transaction Declined—Retry Decline Недопустимый PIN, транзакция отклонена, повтор. +
91 Issuer unavailable or switch inoperative (STIP not applicable or available for this transaction) Issuers can respond with this code, which V.I.P. passes to the acquirer without invoking stand-in processing (STIP). Issuer processors use the code to indicate they cannot perform authorization on issuers’ behalf.Code causes decline at POS. Decline Эмитент недоступен или коммутатор не работает (STIP не применимо или доступно для этой транзакции) Эмитенты могут ответить этим кодом, по которому VIP клиент переходит к эквайеру без вызова stand-in обработки (STIP). Процессинги эмитента используют код для указания того, что они не могут выполнить авторизацию от имени эмитента. Код вызывает отклонение операции в POS. + + +
92 Financial institution or intermediate network facility cannot be found for routing Decline Финансовая организация или сетевые ресурсы не могут найти маршрутизацию до объекта + + +
93 Transaction cannot be completed; violation of law Decline Транзакция не может быть завершена; обнаружено нарушение законодательства +
94 Duplicate transaction. Transaction submitted containing values in tracing data fields that duplicate values in a previous transaction. Decline Дублирующая транзакция. Сопровождающие данные аналогичны значениям в предыдущей транзакции. + + +
96 System malfunction Decline Неисправность системы + + +
B1 Surcharge amount not permitted on Visa cards(U.S. acquirers only) Decline Доплата не допускается на картах Visa(Только для США). Только для POS, для ATM можно. +
N0 Force STIP Decline Задействовать STIP +
N3 Cash service not available Decline Работа с наличными запрещена +
N4 Cashback request exceeds issuer limit Decline Запрос кэшбека превысил лимит +
N7 Decline for CVV2 failure Decline Отклонено т.к. CVV2 неверен +
N8 Transaction amount exceeds pre - authorized approval amount Decline Сумма транзакции превышает предварительно авторизованную сумма +
P2 Invalid biller information Decline Неверная информация биллера +
P5 PIN change/unblock request declined Decline Запрос на изменение/разблокировку PIN отклонен +
P6 Unsafe PIN Decline Небезопасный PIN +
R0 Stop payment order Decline Остановлено платежное поручение +
R1 Revocation of authorization order Decline Авторизация отозвана +
R3 Revocation of all authorizations order Decline Все авторизации отозваны +
Z3 Unable to go online; declined Decline Не возможно выполнить онлайн +
XA Forward to issuer Decline Отправить банку, выпустившему карту +
XD Forward to issuer Decline Отправить банку, выпустившему карту +
Q1 Card authentication failed Or Offline PIN authentication interrupted Decline Ошибка аутентификации карты или прервана аутентификация с помощью PIN +
Sign in
Write to us atinfo@vepay.online
Contact phone+35725654097