curl --request POST \
--url https://api.fintoc.com/v2/account_numbers \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '
{
"account_id": "acc_2hQ9vBmKpR7xLtZ3sWn1fJ4dGcA",
"description": "Payouts CLABE",
"metadata": {
"invoice_id": "12345"
},
"options": {
"min_amount": 1000,
"max_amount": 1000000
}
}
'import requests
url = "https://api.fintoc.com/v2/account_numbers"
payload = {
"account_id": "acc_2hQ9vBmKpR7xLtZ3sWn1fJ4dGcA",
"description": "Payouts CLABE",
"metadata": { "invoice_id": "12345" },
"options": {
"min_amount": 1000,
"max_amount": 1000000
}
}
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({
account_id: 'acc_2hQ9vBmKpR7xLtZ3sWn1fJ4dGcA',
description: 'Payouts CLABE',
metadata: {invoice_id: '12345'},
options: {min_amount: 1000, max_amount: 1000000}
})
};
fetch('https://api.fintoc.com/v2/account_numbers', 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/account_numbers",
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([
'account_id' => 'acc_2hQ9vBmKpR7xLtZ3sWn1fJ4dGcA',
'description' => 'Payouts CLABE',
'metadata' => [
'invoice_id' => '12345'
],
'options' => [
'min_amount' => 1000,
'max_amount' => 1000000
]
]),
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/account_numbers"
payload := strings.NewReader("{\n \"account_id\": \"acc_2hQ9vBmKpR7xLtZ3sWn1fJ4dGcA\",\n \"description\": \"Payouts CLABE\",\n \"metadata\": {\n \"invoice_id\": \"12345\"\n },\n \"options\": {\n \"min_amount\": 1000,\n \"max_amount\": 1000000\n }\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/account_numbers")
.header("Authorization", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"account_id\": \"acc_2hQ9vBmKpR7xLtZ3sWn1fJ4dGcA\",\n \"description\": \"Payouts CLABE\",\n \"metadata\": {\n \"invoice_id\": \"12345\"\n },\n \"options\": {\n \"min_amount\": 1000,\n \"max_amount\": 1000000\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.fintoc.com/v2/account_numbers")
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 \"account_id\": \"acc_2hQ9vBmKpR7xLtZ3sWn1fJ4dGcA\",\n \"description\": \"Payouts CLABE\",\n \"metadata\": {\n \"invoice_id\": \"12345\"\n },\n \"options\": {\n \"min_amount\": 1000,\n \"max_amount\": 1000000\n }\n}"
response = http.request(request)
puts response.read_body{
"id": "acno_2daFu0zqqDtZGJaSi2TGI2Mm1nN",
"object": "account_number",
"account_id": "acc_2hQ9vBmKpR7xLtZ3sWn1fJ4dGcA",
"created_at": "2026-03-01T12:00:00.000Z",
"deleted_at": null,
"description": "Payouts CLABE",
"is_root": false,
"last_transfer_at": null,
"metadata": {
"invoice_id": "12345"
},
"mode": "test",
"number": "646180111800000004",
"options": {
"min_amount": 1000,
"max_amount": 1000000
},
"status": "enabled",
"updated_at": "2026-03-01T12:00:00.000Z"
}Create an account number
Creates a new account number for one of your accounts, in the live or test mode of the API key used. In Mexico, Fintoc generates 18-digit standardized Mexican bank account numbers (CLABEs) for you. In Chile, Fintoc generates the account number for you.
curl --request POST \
--url https://api.fintoc.com/v2/account_numbers \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '
{
"account_id": "acc_2hQ9vBmKpR7xLtZ3sWn1fJ4dGcA",
"description": "Payouts CLABE",
"metadata": {
"invoice_id": "12345"
},
"options": {
"min_amount": 1000,
"max_amount": 1000000
}
}
'import requests
url = "https://api.fintoc.com/v2/account_numbers"
payload = {
"account_id": "acc_2hQ9vBmKpR7xLtZ3sWn1fJ4dGcA",
"description": "Payouts CLABE",
"metadata": { "invoice_id": "12345" },
"options": {
"min_amount": 1000,
"max_amount": 1000000
}
}
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({
account_id: 'acc_2hQ9vBmKpR7xLtZ3sWn1fJ4dGcA',
description: 'Payouts CLABE',
metadata: {invoice_id: '12345'},
options: {min_amount: 1000, max_amount: 1000000}
})
};
fetch('https://api.fintoc.com/v2/account_numbers', 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/account_numbers",
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([
'account_id' => 'acc_2hQ9vBmKpR7xLtZ3sWn1fJ4dGcA',
'description' => 'Payouts CLABE',
'metadata' => [
'invoice_id' => '12345'
],
'options' => [
'min_amount' => 1000,
'max_amount' => 1000000
]
]),
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/account_numbers"
payload := strings.NewReader("{\n \"account_id\": \"acc_2hQ9vBmKpR7xLtZ3sWn1fJ4dGcA\",\n \"description\": \"Payouts CLABE\",\n \"metadata\": {\n \"invoice_id\": \"12345\"\n },\n \"options\": {\n \"min_amount\": 1000,\n \"max_amount\": 1000000\n }\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/account_numbers")
.header("Authorization", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"account_id\": \"acc_2hQ9vBmKpR7xLtZ3sWn1fJ4dGcA\",\n \"description\": \"Payouts CLABE\",\n \"metadata\": {\n \"invoice_id\": \"12345\"\n },\n \"options\": {\n \"min_amount\": 1000,\n \"max_amount\": 1000000\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.fintoc.com/v2/account_numbers")
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 \"account_id\": \"acc_2hQ9vBmKpR7xLtZ3sWn1fJ4dGcA\",\n \"description\": \"Payouts CLABE\",\n \"metadata\": {\n \"invoice_id\": \"12345\"\n },\n \"options\": {\n \"min_amount\": 1000,\n \"max_amount\": 1000000\n }\n}"
response = http.request(request)
puts response.read_body{
"id": "acno_2daFu0zqqDtZGJaSi2TGI2Mm1nN",
"object": "account_number",
"account_id": "acc_2hQ9vBmKpR7xLtZ3sWn1fJ4dGcA",
"created_at": "2026-03-01T12:00:00.000Z",
"deleted_at": null,
"description": "Payouts CLABE",
"is_root": false,
"last_transfer_at": null,
"metadata": {
"invoice_id": "12345"
},
"mode": "test",
"number": "646180111800000004",
"options": {
"min_amount": 1000,
"max_amount": 1000000
},
"status": "enabled",
"updated_at": "2026-03-01T12:00:00.000Z"
}Autorizaciones
Cuerpo
Identifier of the account the new account number belongs to.
"acc_2hQ9vBmKpR7xLtZ3sWn1fJ4dGcA"
Free-text description of the account number.
"Payouts CLABE"
Set of key-value pairs you can attach to the account number for storing additional structured information.
{ "invoice_id": "12345" }
Inbound transfer amount limits for this account number. Currently available for Mexico account numbers only.
Show child attributes
Show child attributes
Respuesta
The created account number.
Unique identifier of the account number.
"acno_2daFu0zqqDtZGJaSi2TGI2Mm1nN"
Type of the object. Always account_number.
Identifier of the account this number belongs to.
"acc_2hQ9vBmKpR7xLtZ3sWn1fJ4dGcA"
Time the account number was created, as an ISO 8601 datetime in UTC.
"2026-03-01T12:00:00.000Z"
Time the account number was deleted, as an ISO 8601 datetime in UTC, or null when not deleted.
null
Free-text description of the account number, or null when none is set.
"Payouts CLABE"
Whether this account number is the account's default.
false
Time of the last transfer received, as an ISO 8601 datetime in UTC, or null when no transfer has been received.
null
Set of key-value pairs attached to the account number.
{ "invoice_id": "12345" }
Whether the account number holds live or test data.
live, test "test"
Account number that receives inbound transfers. In Mexico, the 18-digit standardized Mexican bank account number (CLABE); in Chile, the bank account number.
"646180111800000004"
Inbound transfer amount limits for this account number. Currently available for Mexico account numbers only.
Show child attributes
Show child attributes
Current state of the account number. One of enabled (can receive inbound transfers), disabled (you turned off inbound transfers), blocked (Fintoc blocked inbound transfers), or deleted (removed; see deleted_at).
enabled, disabled, blocked, deleted "enabled"
Time the account number was last updated, as an ISO 8601 datetime in UTC.
"2026-03-01T12:00:00.000Z"
¿Esta página le ayudó?