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	+

API. Integration

Спасибо, чтовыбрали VEPAY!

Спасибо, что
выбрали VEPAY!