curl --request POST \
--url https://api.fintoc.com/v2/entities \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '
{
"country_code": "MX",
"holder_name": "Test Entity 1",
"holder_id": "AAA010101AAA"
}
'import requests
url = "https://api.fintoc.com/v2/entities"
payload = {
"country_code": "MX",
"holder_name": "Test Entity 1",
"holder_id": "AAA010101AAA"
}
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({country_code: 'MX', holder_name: 'Test Entity 1', holder_id: 'AAA010101AAA'})
};
fetch('https://api.fintoc.com/v2/entities', 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/entities",
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([
'country_code' => 'MX',
'holder_name' => 'Test Entity 1',
'holder_id' => 'AAA010101AAA'
]),
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/entities"
payload := strings.NewReader("{\n \"country_code\": \"MX\",\n \"holder_name\": \"Test Entity 1\",\n \"holder_id\": \"AAA010101AAA\"\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/entities")
.header("Authorization", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"country_code\": \"MX\",\n \"holder_name\": \"Test Entity 1\",\n \"holder_id\": \"AAA010101AAA\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.fintoc.com/v2/entities")
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 \"country_code\": \"MX\",\n \"holder_name\": \"Test Entity 1\",\n \"holder_id\": \"AAA010101AAA\"\n}"
response = http.request(request)
puts response.read_body{
"id": "ent_2daFu0zqqDtZGJaSi2TGI2Mm1nN",
"object": "entity",
"holder_id": "AAA010101AAA",
"holder_name": "Test Entity 1",
"is_root": false,
"mode": "test",
"status": "waiting_initialization",
"country_code": "mx",
"capabilities": {
"account_holder": {
"status": "waiting_initialization"
},
"settlement_recipient": {
"status": "waiting_initialization"
}
}
}{
"error": {
"type": "invalid_request_error",
"code": "invalid_country_code",
"param": "country_code",
"message": "Country code 'xx' is not a valid ISO 3166 alpha-2 country code"
}
}{
"error": {
"type": "authentication_error",
"code": "invalid_api_key",
"message": "Invalid API Key: invalid-*oken"
}
}{
"error": {
"type": "invalid_request_error",
"code": "entity_holder_id_already_exists_for_organization",
"message": "An entity with the same holder_id already exists for this organization"
}
}Crear una entidad
Creates an entity in your organization for the mode (live or test) of the API key used. An entity is a legal holder of accounts. Requirements differ by country: in Chile the holder_id is the Chilean tax ID (RUT), and in Mexico it is the Mexican tax ID (RFC). Returns the created entity.
curl --request POST \
--url https://api.fintoc.com/v2/entities \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '
{
"country_code": "MX",
"holder_name": "Test Entity 1",
"holder_id": "AAA010101AAA"
}
'import requests
url = "https://api.fintoc.com/v2/entities"
payload = {
"country_code": "MX",
"holder_name": "Test Entity 1",
"holder_id": "AAA010101AAA"
}
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({country_code: 'MX', holder_name: 'Test Entity 1', holder_id: 'AAA010101AAA'})
};
fetch('https://api.fintoc.com/v2/entities', 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/entities",
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([
'country_code' => 'MX',
'holder_name' => 'Test Entity 1',
'holder_id' => 'AAA010101AAA'
]),
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/entities"
payload := strings.NewReader("{\n \"country_code\": \"MX\",\n \"holder_name\": \"Test Entity 1\",\n \"holder_id\": \"AAA010101AAA\"\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/entities")
.header("Authorization", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"country_code\": \"MX\",\n \"holder_name\": \"Test Entity 1\",\n \"holder_id\": \"AAA010101AAA\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.fintoc.com/v2/entities")
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 \"country_code\": \"MX\",\n \"holder_name\": \"Test Entity 1\",\n \"holder_id\": \"AAA010101AAA\"\n}"
response = http.request(request)
puts response.read_body{
"id": "ent_2daFu0zqqDtZGJaSi2TGI2Mm1nN",
"object": "entity",
"holder_id": "AAA010101AAA",
"holder_name": "Test Entity 1",
"is_root": false,
"mode": "test",
"status": "waiting_initialization",
"country_code": "mx",
"capabilities": {
"account_holder": {
"status": "waiting_initialization"
},
"settlement_recipient": {
"status": "waiting_initialization"
}
}
}{
"error": {
"type": "invalid_request_error",
"code": "invalid_country_code",
"param": "country_code",
"message": "Country code 'xx' is not a valid ISO 3166 alpha-2 country code"
}
}{
"error": {
"type": "authentication_error",
"code": "invalid_api_key",
"message": "Invalid API Key: invalid-*oken"
}
}{
"error": {
"type": "invalid_request_error",
"code": "entity_holder_id_already_exists_for_organization",
"message": "An entity with the same holder_id already exists for this organization"
}
}Autorizaciones
Cuerpo
ISO 3166-1 alpha-2 country code of the entity. In Mexico, the country_code value determines which holder_id values Fintoc accepts: use MX for Mexican entities, or another code, such as US, for foreign entities. In Chile, country_code does not change the holder_id requirements.
"MX"
Legal name of the entity owner.
"Test Entity 1"
Tax identifier of the entity owner. In Chile, use a Chilean tax ID (RUT). This field is always required in Chile, regardless of country_code. In Mexico, use a Mexican tax ID (RFC) without dots or hyphens when country_code is MX. For foreign entities in Mexico, omit this field or send the generic foreign RFC XEXX010101000; Fintoc rejects any other value. The value must be unique within your organization, except XEXX010101000, which can repeat across foreign entities in Mexico.
"AAA010101AAA"
Respuesta
The created entity.
Unique identifier of the entity.
"ent_2daFu0zqqDtZGJaSi2TGI2Mm1nN"
Type of the object. Always entity.
Statuses for the entity's capabilities. A capability is a role the entity can take in Fintoc, such as holding accounts or receiving settlements. Each capability has its own onboarding, so the statuses can differ.
Show child attributes
Show child attributes
ISO 3166-1 alpha-2 country code of the entity, in lowercase, or null when not set. For example, cl or mx.
"mx"
Mexican tax ID (RFC) of the entity owner, without dots or hyphens. For a foreign entity, the value is the generic foreign RFC XEXX010101000.
"AAA010101AAA"
Legal name of the entity owner.
"Test Entity 1"
Whether this entity is your organization's root entity.
true
Whether the entity belongs to live or test data. One of live or test.
live, test "test"
Overall status of the entity. The value is operational when any capability is operational. Otherwise, the value matches the account_holder capability status. Use capabilities to check each capability on its own. One of draft, under_review, pending_signature, canceled, waiting_initialization, operational, rejected, or paused.
draft, under_review, pending_signature, canceled, waiting_initialization, operational, rejected, paused "operational"
¿Esta página le ayudó?