Add a Bank Account

curl --request POST \
  --url https://api-sandbox.finogates.com/v1/platform/bank/add-bank-manually \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "user_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "account_holder_name": "<string>",
  "bank_account_number": "<string>",
  "routing_number": "<string>",
  "account_type": "checking"
}
'

import requests

url = "https://api-sandbox.finogates.com/v1/platform/bank/add-bank-manually"

payload = {
    "user_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "account_holder_name": "<string>",
    "bank_account_number": "<string>",
    "routing_number": "<string>",
    "account_type": "checking"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    user_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    account_holder_name: '<string>',
    bank_account_number: '<string>',
    routing_number: '<string>',
    account_type: 'checking'
  })
};

fetch('https://api-sandbox.finogates.com/v1/platform/bank/add-bank-manually', 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-sandbox.finogates.com/v1/platform/bank/add-bank-manually",
  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([
    'user_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    'account_holder_name' => '<string>',
    'bank_account_number' => '<string>',
    'routing_number' => '<string>',
    'account_type' => 'checking'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "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-sandbox.finogates.com/v1/platform/bank/add-bank-manually"

	payload := strings.NewReader("{\n  \"user_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"account_holder_name\": \"<string>\",\n  \"bank_account_number\": \"<string>\",\n  \"routing_number\": \"<string>\",\n  \"account_type\": \"checking\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	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-sandbox.finogates.com/v1/platform/bank/add-bank-manually")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"user_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"account_holder_name\": \"<string>\",\n  \"bank_account_number\": \"<string>\",\n  \"routing_number\": \"<string>\",\n  \"account_type\": \"checking\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api-sandbox.finogates.com/v1/platform/bank/add-bank-manually")

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

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"user_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"account_holder_name\": \"<string>\",\n  \"bank_account_number\": \"<string>\",\n  \"routing_number\": \"<string>\",\n  \"account_type\": \"checking\"\n}"

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

{
  "status_code": 123,
  "data": "<unknown>",
  "query_generated_time": 123
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

Add Bank Account

Save a bank account so one of your users can pay with it.

The bank account is stored safely and kept encrypted. After it is saved, our responses only ever show a masked version (a masked account number and the last 4 digits of the routing number) — the full account number is never shown again.

What you need to send

user_id — the user this bank account belongs to
account_holder_name — the name on the bank account
bank_account_number — the full bank account number
routing_number — the bank’s 9-digit routing number

POST

platform

bank

add-bank-manually

Add a Bank Account

curl --request POST \
  --url https://api-sandbox.finogates.com/v1/platform/bank/add-bank-manually \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "user_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "account_holder_name": "<string>",
  "bank_account_number": "<string>",
  "routing_number": "<string>",
  "account_type": "checking"
}
'

import requests

url = "https://api-sandbox.finogates.com/v1/platform/bank/add-bank-manually"

payload = {
    "user_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "account_holder_name": "<string>",
    "bank_account_number": "<string>",
    "routing_number": "<string>",
    "account_type": "checking"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    user_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    account_holder_name: '<string>',
    bank_account_number: '<string>',
    routing_number: '<string>',
    account_type: 'checking'
  })
};

fetch('https://api-sandbox.finogates.com/v1/platform/bank/add-bank-manually', 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-sandbox.finogates.com/v1/platform/bank/add-bank-manually",
  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([
    'user_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    'account_holder_name' => '<string>',
    'bank_account_number' => '<string>',
    'routing_number' => '<string>',
    'account_type' => 'checking'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "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-sandbox.finogates.com/v1/platform/bank/add-bank-manually"

	payload := strings.NewReader("{\n  \"user_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"account_holder_name\": \"<string>\",\n  \"bank_account_number\": \"<string>\",\n  \"routing_number\": \"<string>\",\n  \"account_type\": \"checking\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	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-sandbox.finogates.com/v1/platform/bank/add-bank-manually")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"user_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"account_holder_name\": \"<string>\",\n  \"bank_account_number\": \"<string>\",\n  \"routing_number\": \"<string>\",\n  \"account_type\": \"checking\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api-sandbox.finogates.com/v1/platform/bank/add-bank-manually")

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

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"user_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"account_holder_name\": \"<string>\",\n  \"bank_account_number\": \"<string>\",\n  \"routing_number\": \"<string>\",\n  \"account_type\": \"checking\"\n}"

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

{
  "status_code": 123,
  "data": "<unknown>",
  "query_generated_time": 123
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

Authorizations

Authorization

string

header

required

The access token received from the authorization server in the OAuth 2.0 flow.

Body

application/json

Add a bank account as a payment method.

user_id

string<uuid>

required

Owner user UUID.

Example:

"b3a9b622-cc63-4d3c-aad6-2d8e29e6f9d4"

account_holder_name

string

required

Name of the account holder.

Maximum string length: 120

Example:

"John Doe"

bank_account_number

string

required

Full bank account number.

Required string length: 4 - 34

Example:

"1234567890"

routing_number

string

required

ACH routing number (9 digits).

Required string length: 9

Example:

"021000021"

account_type

string | null

Account type (e.g. checking, savings).

Maximum string length: 30

Example:

"checking"

Response

Successful Response

Standard response wrapper for single-object responses and errors.

Generic over the payload type. A route that declares CommonResponse[SomeModel] gets the real data schema rendered in OpenAPI/Swagger; a bare CommonResponse leaves data untyped.

status_code

integer

required

HTTP status code for the response.

data

any

required

Payload or error details.

query_generated_time

integer

required

UTC timestamp (milliseconds since epoch) when response was generated.

Create User KYB Record List Bank Accounts

Auth

Users

Payees

Verification

Bank Accounts

Card Processing

Digital Assets

International

Pending Applications

Wallets

Payments

Catalog

Webhooks

Phone Numbers

Sms

Calls

Listings

Embed Tokens

Add Bank Account

What you need to send

Authorizations

Body

Response