Bank-Accounts

A bank account object shows the cbank account information for a particular customer

Download Bank-Accounts OpenAPI Document

End Points

GET

/customers/{customer_id}/bankaccounts/{account_id}

Attribute

account_id

string

Account ID of the bank account from which payment is about to made by the customer.

customer_id

string

Unique ID associated with the customer.

customer_name

string

Name of the customer, whom the bank account is associated.

gateway

string

Payment gateway through which payment needs to be made. Supported payment gateway values test_gateway, payflow_pro, stripe, 2checkout, authorize_net, payments_pro, forte, worldpay, wepay.

last_four_digits

integer

Last four digits of the customer's bank account.

status

string

Status of the bank account.

last_modified_time

string

Time at which the contact person details were last updated.

created_time

string

Time at which the contact person was created.

created_by_id

string

Unique ID to denote the user who added the bank account.

created_by_name

string

Name of the user who added the bank account.

{
    "account_id": "90300000079126",
    "customer_id": "9030000005664",
    "customer_name": "Bowman Furniture",
    "gateway": "authorize_net",
    "last_four_digits": 2,
    "status": "active",
    "last_modified_time": "2016-06-05T02:30:08-0700",
    "created_time": "2016-06-05T12:30:08-0700",
    "created_by_id": "9030000067542",
    "created_by_name": "Benjamin"
}

Retrieve a bank account information

Details of an existing bank account.
OAuth Scope : ZohoSubscriptions.customers.READ

Path Parameters

customer_id

string

(Required)

Unique identifier of the customer.

account_id

string

(Required)

Unique identifier of the bank account.

Headers

X-com-zoho-subscriptions-organizationid

string

(Required)

ID of the organization

Request Example

headers_data = Map();
headers_data.put("X-com-zoho-subscriptions-organizationid", "10234695");
headers_data.put("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f");
response = invokeUrl
[
url: "https://www.zohoapis.com/billing/v1/customers/9030000005664/bankaccounts/90300000079126"
type: GET
headers: headers_data
connection: <connection_name>
];
info response;

OkHttpClient client = new OkHttpClient();

Request request = new Request.Builder()
  .url("https://www.zohoapis.com/billing/v1/customers/9030000005664/bankaccounts/90300000079126")
  .get()
  .addHeader("X-com-zoho-subscriptions-organizationid", "10234695")
  .addHeader("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f")
  .build();

Response response = client.newCall(request).execute();

const options = {
  method: 'GET',
  headers: {
    'X-com-zoho-subscriptions-organizationid': '10234695',
    Authorization: 'Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'
  }
};

fetch('https://www.zohoapis.com/billing/v1/customers/9030000005664/bankaccounts/90300000079126', options)
  .then(response => response.json())
  .then(response => console.log(response))
  .catch(err => console.error(err));

import http.client

conn = http.client.HTTPSConnection("www.zohoapis.com")

headers = {
    'X-com-zoho-subscriptions-organizationid': "10234695",
    'Authorization': "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f"
    }

conn.request("GET", "/billing/v1/customers/9030000005664/bankaccounts/90300000079126", headers=headers)

res = conn.getresponse()
data = res.read()

print(data.decode("utf-8"))

const http = require("https");

const options = {
  "method": "GET",
  "hostname": "www.zohoapis.com",
  "port": null,
  "path": "/billing/v1/customers/9030000005664/bankaccounts/90300000079126",
  "headers": {
    "X-com-zoho-subscriptions-organizationid": "10234695",
    "Authorization": "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f"
  }
};

const req = http.request(options, function (res) {
  const chunks = [];

  res.on("data", function (chunk) {
    chunks.push(chunk);
  });

  res.on("end", function () {
    const body = Buffer.concat(chunks);
    console.log(body.toString());
  });
});

req.end();

curl --request GET \
  --url https://www.zohoapis.com/billing/v1/customers/9030000005664/bankaccounts/90300000079126 \
  --header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f' \
  --header 'X-com-zoho-subscriptions-organizationid: 10234695'

{
    "code": 0,
    "message": "success",
    "bank_accounts": [
        {
            "account_id": "90300000079126",
            "customer_id": "9030000005664",
            "customer_name": "Bowman Furniture",
            "gateway": "authorize_net",
            "last_four_digits": 2,
            "status": "active",
            "last_modified_time": "2016-06-05T02:30:08-0700",
            "created_time": "2016-06-05T12:30:08-0700",
            "created_by_id": "9030000067542",
            "created_by_name": "Benjamin"
        },
        {...},
        {...}
    ]
}