API. Integration

MFIs: https://api.vepay.online/mfo

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. Authorization parameters are contained in the request header:

Token algorithm:

SHA1(SHA1(key) + SHA1 (request body)), where SHA1 produces a 40-character string with a hexadecimal hash value.

If the request is successfully handled, an HTTP 200 code will be returned. In the event of an authorization 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 response body:

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 API

1. 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).

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-кодам: