Create Deposit

To initiate a deposit transaction within Vevopay, please refer to the information provided on this page. Additionally, ensure you consult the Important Information page for details on hashcode.

Creating a new Deposit

• The CustomerDeposit method processes customer deposit requests.

CustomerDeposit

HTTP: POST

https://vevopay.io/api/Vevo/CustomerDeposit

Creates a new deposit.

Headers

Name	Type	Description
WebApiKey*	String	API key for authentication and authorization (ask it from Vevopay officials)

Request Body (fields marked with * are required)

Name	Type	Description
amount*	string	amount of the transaction
userId*	string	userid
name*	string	name of the user
username*	string	username
IslemTuru*	String	type of transaction (check the methodlist)
processId*	String	your transaction id
RedirectUrl	String	URL address where the user should be redirected after the transaction

201: Deposit successfully created

// check out the important information page for hashcode and method list

{
    "status": "successful",
    "url": "https://vevopay.io/iFrame/Papara?trackingID=a425de30-3a39-45a9-aea3-62edd4f522ac",
    "hashcode": "3a3cc62daab0f7aade1e0c718c40a2e7", 
    "hataMesaj": null,
    "trackingId": "a425de30-3a39-45a9-aea3-62edd4f522ac"
}

400/401: Bad Request

// message includes the description of the error.

{
  "message": "error_message_returned"
}

// Example Curl for the CustomerDeposit endpoint

curl --location 'https://vevopay.io/api/Vevo/CustomerDeposit' \
--header 'WebApiKey: xxxxxxxxx' \
--header 'Content-Type: application/json' \
--data '{
    "userId": "testuser",
    "name": "test user name",
    "username": "testuser",
    "IslemTuru": "papara",
    "processId": "test",
    "redirectUrl": "https://www.google.com/"
}'

Please note the successful status returned by the CustomerDepositmethod does not indicate a successfully finished transaction, rather it indicates that the record of the transaction request is successfully taken. Final result of the of transaction process will be sent from us to your callback URLs, please refer to the Callback page.

Example Usage

C#

public class YourController : Controller
{
    public async Task<ActionResult> SendApiRequest()
    {
        using (var client = new HttpClient())
        {
            var values = new
            {
                processId = "your_process_id",
                IslemTuru = "your_islem_turu",
                amount = "your_amount",
                userId = "your_user_id",
                name = "your_name",
                username = "your_username"
            };

            client.DefaultRequestHeaders.Add("WebApiKey", "your_web_api_key");

            var json = JsonConvert.SerializeObject(values);
            var content = new StringContent(json, System.Text.Encoding.UTF8, "application/json");
            var response = await client.PostAsync("https://vevopay.io/api/Vevo/CustomerDeposit", content);

            if (!response.IsSuccessStatusCode)
            {
                // Handle error or throw exception
                return View("Error"); 
            }

            var responseString = await response.Content.ReadAsStringAsync();
            var responseObject = JsonConvert.DeserializeObject<dynamic>(responseString);

            return View(responseObject); // Send response from API to a view
        }
    }
}

Python

import requests

url = "https://vevopay.io/api/Vevo/CustomerDeposit"

headers = {
    "WebApiKey": "your_web_api_key"
}

data = {
    "processId": "your_process_id",
    "IslemTuru": "your_islem_turu",
    "amount": "your_amount",
    "userId": "your_user_id",
    "name": "your_name",
    "username": "your_username"
}

response = requests.post(url, headers=headers, data=data)

Java

import java.net.HttpURLConnection;
import java.net.URL;
import java.io.OutputStream;
import java.net.URLEncoder;
import java.nio.charset.StandardCharsets;

public class Main {
    public static void main(String[] args) {
        try {
            URL url = new URL("https://vevopay.io/api/Vevo/CustomerDeposit");
            HttpURLConnection conn = (HttpURLConnection) url.openConnection();
            conn.setRequestMethod("POST");
            conn.setRequestProperty("Content-Type", "application/x-www-form-urlencoded");
            conn.setRequestProperty("WebApiKey", "your_web_api_key");
            conn.setDoOutput(true);

            String data = "processId=" + URLEncoder.encode("your_process_id", StandardCharsets.UTF_8.name()) +
                          "&IslemTuru=" + URLEncoder.encode("your_islem_turu", StandardCharsets.UTF_8.name()) +
                          "&amount=" + URLEncoder.encode("your_amount", StandardCharsets.UTF_8.name()) +
                          "&userId=" + URLEncoder.encode("your_user_id", StandardCharsets.UTF_8.name()) +
                          "&name=" + URLEncoder.encode("your_name", StandardCharsets.UTF_8.name()) +
                          "&username=" + URLEncoder.encode("your_username", StandardCharsets.UTF_8.name());

            try(OutputStream os = conn.getOutputStream()) {
                byte[] input = data.getBytes(StandardCharsets.UTF_8);
                os.write(input, 0, input.length);           
            }

            int responseCode = conn.getResponseCode();
            System.out.println("Response Code : " + responseCode);

        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

PHP

<?php

$url = "https://vevopay.io/api/Vevo/CustomerDeposit";

$headers = [
    "WebApiKey: your_web_api_key"
];

$data = http_build_query([
    "processId" => "your_process_id",
    "IslemTuru" => "your_islem_turu",
    "amount" => "your_amount",
    "userId" => "your_user_id",
    "name" => "your_name",
    "username" => "your_username"
]);

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
curl_close($ch);

echo $response;
?>