List Deposit Methods

curl --request GET \
  --url https://api.vitawallet.io/api/businesses/deposits \
  --header 'Authorization: <api-key>' \
  --header 'x-date: <api-key>' \
  --header 'x-login: <api-key>' \
  --header 'x-trans-key: <api-key>'

import requests

url = "https://api.vitawallet.io/api/businesses/deposits"

headers = {
    "x-login": "<api-key>",
    "x-trans-key": "<api-key>",
    "x-date": "<api-key>",
    "Authorization": "<api-key>"
}

response = requests.get(url, headers=headers)

print(response.text)

const options = {
  method: 'GET',
  headers: {
    'x-login': '<api-key>',
    'x-trans-key': '<api-key>',
    'x-date': '<api-key>',
    Authorization: '<api-key>'
  }
};

fetch('https://api.vitawallet.io/api/businesses/deposits', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.vitawallet.io/api/businesses/deposits",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>",
    "x-date: <api-key>",
    "x-login: <api-key>",
    "x-trans-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.vitawallet.io/api/businesses/deposits"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-login", "<api-key>")
	req.Header.Add("x-trans-key", "<api-key>")
	req.Header.Add("x-date", "<api-key>")
	req.Header.Add("Authorization", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.vitawallet.io/api/businesses/deposits")
  .header("x-login", "<api-key>")
  .header("x-trans-key", "<api-key>")
  .header("x-date", "<api-key>")
  .header("Authorization", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.vitawallet.io/api/businesses/deposits")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-login"] = '<api-key>'
request["x-trans-key"] = '<api-key>'
request["x-date"] = '<api-key>'
request["Authorization"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "user_id": 4454,
  "deposits": [
    {
      "deposit_id": "dep_clp_001",
      "status": "active",
      "type": "business",
      "currencies": [
        "USDC",
        "ARS",
        "MXN",
        "COP",
        "BRL",
        "USD",
        "USDT",
        "EUR",
        "BTC",
        "CLP"
      ],
      "country": "CL",
      "data": {
        "provider": "Vita Usuario",
        "email": "business@vitawallet.io"
      },
      "rules": {
        "time_to_credit": "Al instante",
        "fees": "0%",
        "min_amount": null
      }
    },
    {
      "deposit_id": "dep_clp_002",
      "status": "active",
      "type": "business",
      "currencies": [
        "CLP"
      ],
      "country": "CL",
      "data": {
        "provider": "Transferencia bancaria",
        "bank": "Banco BCI",
        "account_number": 10725105,
        "holder_name": "Vita Solutions S.p.A.",
        "document": "76.974.041-4",
        "email": "ayuda@vitawallet.io",
        "account_type": "Corriente"
      },
      "rules": {
        "time_to_credit": "5 min a 1 hora",
        "fees": 0,
        "min_amount": 200
      }
    },
    {
      "deposit_id": "dep_clp_003",
      "status": "active",
      "type": "business",
      "currencies": [
        "CLP"
      ],
      "country": "CL",
      "data": {
        "provider": "Paga con tu banco"
      },
      "rules": {
        "time_to_credit": "5 min a 1 hora",
        "fees": 500,
        "min_amount": 1
      }
    },
    {
      "deposit_id": "dep_clp_004",
      "status": "active",
      "type": "business",
      "currencies": [
        "CLP"
      ],
      "country": "CL",
      "data": {
        "provider": "Webpay"
      },
      "rules": {
        "time_to_credit": "5 min a 1 hora",
        "fees": "3.5%",
        "min_amount": 200
      }
    },
    {
      "deposit_id": "dep_clp_005",
      "status": "active",
      "type": "business",
      "currencies": [
        "CLP"
      ],
      "country": "CL",
      "data": {
        "provider": "Binance Pay"
      },
      "rules": {
        "time_to_credit": "5 min a 1 hora",
        "fees": "1.55%",
        "min_amount": 200
      }
    },
    {
      "deposit_id": "dep_clp_006",
      "status": "active",
      "type": "business",
      "currencies": [
        "EUR"
      ],
      "country": "CL",
      "data": {
        "provider": "Transferencia bancaria"
      },
      "rules": {
        "time_to_credit": "5 min a 1 hora",
        "fees": 0,
        "min_amount": 1
      }
    },
    {
      "deposit_id": "dep_clp_007",
      "status": "active",
      "type": "business",
      "currencies": [
        "USD"
      ],
      "country": "CL",
      "data": {
        "provider": "Skrill"
      },
      "rules": {
        "time_to_credit": "5 min a 1 hora",
        "fees": "4.0%",
        "min_amount": 5
      }
    }
  ]
}

User Information

List Deposit Methods

This method show Vita Business prices, in order to calculate transactions final amount.

Withdrawal prices

Structure

Field	Description
`valid_until`	Price deadline
`business_days_of_payment`	Number of business days Vita Wallet Business needs to complete payment on destination bank account
`clp_sell`	CLP Sell price
`fixed_cost`	Fixed cost in destination country local
`fixed_cost_usd`	Fixed cost in USD
`min_amount`	Minimum amount for withdrawal

The selling price fields correspond to the active balances of the account. For example, if there is an active balance in ARS, there will be an ars_sell field.

Vita transfer prices

For prices related to transfers to Vita users, there is a vita_sent section.

Structure

Field	Description
`valid_until`	Price deadline
`clp_sell`	CLP Sell price
`fixed_cost`	Fixed cost in destination country local
`fixed_cost_usd`	Fixed cost in USD

Here the selling price fields correspond to the active balances of the account as well.

Currency sections

You can also obtain vita_sent or withdrawal prices from each of the currency sections. For example, if you have clp active balance, you will also get a clp object with its withdrawal and vita_sent prices object structure.

Final amount

To calculate the final amount, you must multiply the amount to be sent by the CLP or the currency of origin of your account sale price in the destination country, also remember that you must subtract the fixed cost of the destination country.

const finalAmount = (amount * withdrawal.prices.attributes["clp_sell"]["co"]) - withdrawal.prices.attributes["fixed_cost"]["co"];

Sent price

Structure

Field	Description
`valid_until`	Price deadline
`clp_sell`	CLP Sell price
`fixed_cost`	Fixed cost in destination country local

Final amount

const finalAmount = (amount * vita_send.prices.attributes["clp_sell"]["co"]) - vita_send.prices.attributes["fixed_cost"]["co"];

Multicurrency

Now Vita Business allows you to use all the currencies available in your wallet, to calculate the destination amount you must use the previous formulas, but selecting the corresponding source currency, for example, if you want to use USD as the source currency, you must select the settings prices for endpoint usd /businesses/prices.

To calculate the final amount, you must multiply the amount to be sent by the USD sales price of your account in the destination country, also remember to subtract the fixed cost of the destination country.

const finalAmount = (amount * usd.withdrawal.prices.attributes["usd_sell"]["co"]) - usd.withdrawal.prices.attributes["fixed_cost"]["co"];

If you want to use COP, you must use the COP key of the pricing endpoint

To calculate the final amount, you must multiply the amount to be sent by the COP sales price of your account in the destination country, also remember to subtract the fixed cost of the destination country.

const finalAmount = (amount * cop.withdrawal.prices.attributes["cop_sell"]["cl"]) - cop.withdrawal.prices.attributes["fixed_cost"]["cl"];

Payins prices

currency_destiny Indicates the ISO currency code in which the owner of the payment link will receive the funds.

If this parameter is sent in the URL, it can be used to fetch pay-in prices in the specified destination currency.
This parameter is optional. If omitted, prices will be loaded using the default destination currency configured for the payment link owner.

/api/businesses/prices?currency_destiny=COP

Structure

Field	Description
`destination_currency`	Currency used to credit payment to the Vita account
`source_currency`	Local currency of the country
`payment_methods`	Country payment method

Payment method structure

Field	Description
`payment_method`	Payment method name
`fixed_cost`	Fixed cost in the crediting currency
`spread`	Sell spread
`spread_type`	Spread type (percentage)
`sell_price`	Sell price

Final amount

You can get the amount in the credit currency of a payment link using the following equation.

const finalAmount = ( amount * sell_price ) - fixed_cost

GET

api

businesses

deposits

List Deposit Methods

curl --request GET \
  --url https://api.vitawallet.io/api/businesses/deposits \
  --header 'Authorization: <api-key>' \
  --header 'x-date: <api-key>' \
  --header 'x-login: <api-key>' \
  --header 'x-trans-key: <api-key>'

import requests

url = "https://api.vitawallet.io/api/businesses/deposits"

headers = {
    "x-login": "<api-key>",
    "x-trans-key": "<api-key>",
    "x-date": "<api-key>",
    "Authorization": "<api-key>"
}

response = requests.get(url, headers=headers)

print(response.text)

const options = {
  method: 'GET',
  headers: {
    'x-login': '<api-key>',
    'x-trans-key': '<api-key>',
    'x-date': '<api-key>',
    Authorization: '<api-key>'
  }
};

fetch('https://api.vitawallet.io/api/businesses/deposits', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.vitawallet.io/api/businesses/deposits",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>",
    "x-date: <api-key>",
    "x-login: <api-key>",
    "x-trans-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.vitawallet.io/api/businesses/deposits"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-login", "<api-key>")
	req.Header.Add("x-trans-key", "<api-key>")
	req.Header.Add("x-date", "<api-key>")
	req.Header.Add("Authorization", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.vitawallet.io/api/businesses/deposits")
  .header("x-login", "<api-key>")
  .header("x-trans-key", "<api-key>")
  .header("x-date", "<api-key>")
  .header("Authorization", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.vitawallet.io/api/businesses/deposits")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-login"] = '<api-key>'
request["x-trans-key"] = '<api-key>'
request["x-date"] = '<api-key>'
request["Authorization"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "user_id": 4454,
  "deposits": [
    {
      "deposit_id": "dep_clp_001",
      "status": "active",
      "type": "business",
      "currencies": [
        "USDC",
        "ARS",
        "MXN",
        "COP",
        "BRL",
        "USD",
        "USDT",
        "EUR",
        "BTC",
        "CLP"
      ],
      "country": "CL",
      "data": {
        "provider": "Vita Usuario",
        "email": "business@vitawallet.io"
      },
      "rules": {
        "time_to_credit": "Al instante",
        "fees": "0%",
        "min_amount": null
      }
    },
    {
      "deposit_id": "dep_clp_002",
      "status": "active",
      "type": "business",
      "currencies": [
        "CLP"
      ],
      "country": "CL",
      "data": {
        "provider": "Transferencia bancaria",
        "bank": "Banco BCI",
        "account_number": 10725105,
        "holder_name": "Vita Solutions S.p.A.",
        "document": "76.974.041-4",
        "email": "ayuda@vitawallet.io",
        "account_type": "Corriente"
      },
      "rules": {
        "time_to_credit": "5 min a 1 hora",
        "fees": 0,
        "min_amount": 200
      }
    },
    {
      "deposit_id": "dep_clp_003",
      "status": "active",
      "type": "business",
      "currencies": [
        "CLP"
      ],
      "country": "CL",
      "data": {
        "provider": "Paga con tu banco"
      },
      "rules": {
        "time_to_credit": "5 min a 1 hora",
        "fees": 500,
        "min_amount": 1
      }
    },
    {
      "deposit_id": "dep_clp_004",
      "status": "active",
      "type": "business",
      "currencies": [
        "CLP"
      ],
      "country": "CL",
      "data": {
        "provider": "Webpay"
      },
      "rules": {
        "time_to_credit": "5 min a 1 hora",
        "fees": "3.5%",
        "min_amount": 200
      }
    },
    {
      "deposit_id": "dep_clp_005",
      "status": "active",
      "type": "business",
      "currencies": [
        "CLP"
      ],
      "country": "CL",
      "data": {
        "provider": "Binance Pay"
      },
      "rules": {
        "time_to_credit": "5 min a 1 hora",
        "fees": "1.55%",
        "min_amount": 200
      }
    },
    {
      "deposit_id": "dep_clp_006",
      "status": "active",
      "type": "business",
      "currencies": [
        "EUR"
      ],
      "country": "CL",
      "data": {
        "provider": "Transferencia bancaria"
      },
      "rules": {
        "time_to_credit": "5 min a 1 hora",
        "fees": 0,
        "min_amount": 1
      }
    },
    {
      "deposit_id": "dep_clp_007",
      "status": "active",
      "type": "business",
      "currencies": [
        "USD"
      ],
      "country": "CL",
      "data": {
        "provider": "Skrill"
      },
      "rules": {
        "time_to_credit": "5 min a 1 hora",
        "fees": "4.0%",
        "min_amount": 5
      }
    }
  ]
}

Authorizations

Business xLogin

x-trans-key

string

header

required

Business xTransKey

x-date

string

header

required

ISO8601 datetime

Authorization

string

header

required

V2-HMAC-SHA256 signature. Example: V2-HMAC-SHA256, Signature: <hash>

Response

200 - application/json

Successful response.

Payins

Exchange

Payouts

Transactions

Users

Webhooks

List Deposit Methods

Withdrawal prices

Structure

Vita transfer prices

Structure

Final amount

Sent price

Structure

Final amount

Multicurrency

Payins prices

Structure

Payment method structure

Authorizations

Response