curl --request POST \
--url https://api.fintoc.com/v2/accounts \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '
{
"entity_id": "ent_2eGhTp1rLqWnXkZbYc4JsKmAvD9",
"description": "Main collection account",
"number": "123456789"
}
'import requests
url = "https://api.fintoc.com/v2/accounts"
payload = {
"entity_id": "ent_2eGhTp1rLqWnXkZbYc4JsKmAvD9",
"description": "Main collection account",
"number": "123456789"
}
headers = {
"Authorization": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
entity_id: 'ent_2eGhTp1rLqWnXkZbYc4JsKmAvD9',
description: 'Main collection account',
number: '123456789'
})
};
fetch('https://api.fintoc.com/v2/accounts', 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.fintoc.com/v2/accounts",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'entity_id' => 'ent_2eGhTp1rLqWnXkZbYc4JsKmAvD9',
'description' => 'Main collection account',
'number' => '123456789'
]),
CURLOPT_HTTPHEADER => [
"Authorization: <api-key>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.fintoc.com/v2/accounts"
payload := strings.NewReader("{\n \"entity_id\": \"ent_2eGhTp1rLqWnXkZbYc4JsKmAvD9\",\n \"description\": \"Main collection account\",\n \"number\": \"123456789\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.fintoc.com/v2/accounts")
.header("Authorization", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"entity_id\": \"ent_2eGhTp1rLqWnXkZbYc4JsKmAvD9\",\n \"description\": \"Main collection account\",\n \"number\": \"123456789\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.fintoc.com/v2/accounts")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"entity_id\": \"ent_2eGhTp1rLqWnXkZbYc4JsKmAvD9\",\n \"description\": \"Main collection account\",\n \"number\": \"123456789\"\n}"
response = http.request(request)
puts response.read_bodyCreate an account
Creates an account for an entity of your organization, in the live or test mode of the API key used. Every account gets a root account number. In Mexico, the account gets a standardized Mexican bank account number (CLABE) that Fintoc generates for you. In Chile, the account gets a number that Fintoc generates unless you choose your own with number.
curl --request POST \
--url https://api.fintoc.com/v2/accounts \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '
{
"entity_id": "ent_2eGhTp1rLqWnXkZbYc4JsKmAvD9",
"description": "Main collection account",
"number": "123456789"
}
'import requests
url = "https://api.fintoc.com/v2/accounts"
payload = {
"entity_id": "ent_2eGhTp1rLqWnXkZbYc4JsKmAvD9",
"description": "Main collection account",
"number": "123456789"
}
headers = {
"Authorization": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
entity_id: 'ent_2eGhTp1rLqWnXkZbYc4JsKmAvD9',
description: 'Main collection account',
number: '123456789'
})
};
fetch('https://api.fintoc.com/v2/accounts', 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.fintoc.com/v2/accounts",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'entity_id' => 'ent_2eGhTp1rLqWnXkZbYc4JsKmAvD9',
'description' => 'Main collection account',
'number' => '123456789'
]),
CURLOPT_HTTPHEADER => [
"Authorization: <api-key>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.fintoc.com/v2/accounts"
payload := strings.NewReader("{\n \"entity_id\": \"ent_2eGhTp1rLqWnXkZbYc4JsKmAvD9\",\n \"description\": \"Main collection account\",\n \"number\": \"123456789\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.fintoc.com/v2/accounts")
.header("Authorization", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"entity_id\": \"ent_2eGhTp1rLqWnXkZbYc4JsKmAvD9\",\n \"description\": \"Main collection account\",\n \"number\": \"123456789\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.fintoc.com/v2/accounts")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"entity_id\": \"ent_2eGhTp1rLqWnXkZbYc4JsKmAvD9\",\n \"description\": \"Main collection account\",\n \"number\": \"123456789\"\n}"
response = http.request(request)
puts response.read_bodyAuthorizations
Body
Identifier of the entity that owns the account.
"ent_2eGhTp1rLqWnXkZbYc4JsKmAvD9"
Free-text description of the account. Up to 40 characters.
"Main collection account"
Root account number to assign to the new account in Chile. Must be a string of 4 to 17 digits; Fintoc removes leading zeros before assigning the account number. Defaults to a Fintoc-generated number; for Mexico accounts, Fintoc ignores this value and always generates the CLABE.
"123456789"
Response
The created account.
Unique identifier of the account.
"acc_2daFu0zqqDtZGJaSi2TGI2Mm1nN"
Type of the object. Always account.
Available balance of the account, in the smallest currency unit. For MXN the smallest unit is the centavo; for CLP it is the peso, which has no minor unit.
1050000
ISO 4217 currency code of the account. One of CLP, MXN.
CLP, MXN "MXN"
Free-text description of the account, or null when none is set.
"Main collection account"
Owner entity of the account.
Show child attributes
Show child attributes
Whether this account is the organization's root account.
true
Whether the account holds live or test data.
live, test "test"
Default account number of the account. In Mexico, the 18-digit standardized bank account number (CLABE); in Chile, the bank account number.
"646180111800000004"
Identifier of the default account number.
"acno_2fJkRm7tBvQxNzYpLc5WsHaDfT3"
Status of the account. One of active, blocked, closed.
active, blocked, closed "active"
Was this page helpful?