Create bank account
curl --request POST \
--url https://api.noyax.com/api/v1/finance/bank-accounts \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'X-CompanyID: <x-companyid>' \
--header 'X-UserID: <x-userid>' \
--data '
{
"BankName": "İŞ BANKASI",
"Name": "İş Bankası TRY Hesabı",
"AccountType": 1,
"CurrencyCode": "TRY"
}
'using RestSharp;
var options = new RestClientOptions("https://api.noyax.com/api/v1/finance/bank-accounts");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("X-UserID", "<x-userid>");
request.AddHeader("X-CompanyID", "<x-companyid>");
request.AddHeader("Authorization", "Bearer <token>");
request.AddJsonBody("{\n \"BankName\": \"İŞ BANKASI\",\n \"Name\": \"İş Bankası TRY Hesabı\",\n \"AccountType\": 1,\n \"CurrencyCode\": \"TRY\"\n}", false);
var response = await client.PostAsync(request);
Console.WriteLine("{0}", response.Content);
const options = {
method: 'POST',
headers: {
'X-UserID': '<x-userid>',
'X-CompanyID': '<x-companyid>',
Authorization: 'Bearer <token>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
BankName: 'İŞ BANKASI',
Name: 'İş Bankası TRY Hesabı',
AccountType: 1,
CurrencyCode: 'TRY'
})
};
fetch('https://api.noyax.com/api/v1/finance/bank-accounts', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.noyax.com/api/v1/finance/bank-accounts"
payload = {
"BankName": "İŞ BANKASI",
"Name": "İş Bankası TRY Hesabı",
"AccountType": 1,
"CurrencyCode": "TRY"
}
headers = {
"X-UserID": "<x-userid>",
"X-CompanyID": "<x-companyid>",
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"Success": true,
"ResultCode": "0000",
"Data": {
"Id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"BankId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"CurrencyId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"BankName": "İŞ BANKASI",
"Name": "İş Bankası TRY Hesabı",
"BranchName": "<string>",
"BranchCode": "<string>",
"AccountNumber": "<string>",
"Iban": "<string>",
"AccountType": 1,
"CurrencyCode": "TRY",
"IsDisabled": false,
"SharingCode": "<string>"
},
"Message": "<string>"
}{
"Success": false,
"ResultCode": "8016",
"Message": "AccountType must be between 1 and 4.",
"Errors": [
{
"Code": "8016",
"Message": "AccountType must be between 1 and 4."
}
]
}{
"Success": false,
"ResultCode": "0102",
"Message": "Token has expired. Obtain a new token using the refresh token.",
"Errors": [
{
"Code": "0102",
"Message": "Token has expired. Obtain a new token using the refresh token."
}
]
}{
"Success": false,
"ResultCode": "0110",
"Message": "You do not have permission for this operation.",
"Errors": [
{
"Code": "0110",
"Message": "You do not have permission for this operation."
}
]
}{
"Success": false,
"ResultCode": "0120",
"Message": "Daily request limit (10000) exceeded.",
"Errors": [
{
"Code": "0120",
"Message": "Daily request limit (10000) exceeded."
}
]
}Bank accounts
Create bank account
Adds a bank account.
POST
/
api
/
v1
/
finance
/
bank-accounts
Create bank account
curl --request POST \
--url https://api.noyax.com/api/v1/finance/bank-accounts \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'X-CompanyID: <x-companyid>' \
--header 'X-UserID: <x-userid>' \
--data '
{
"BankName": "İŞ BANKASI",
"Name": "İş Bankası TRY Hesabı",
"AccountType": 1,
"CurrencyCode": "TRY"
}
'using RestSharp;
var options = new RestClientOptions("https://api.noyax.com/api/v1/finance/bank-accounts");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("X-UserID", "<x-userid>");
request.AddHeader("X-CompanyID", "<x-companyid>");
request.AddHeader("Authorization", "Bearer <token>");
request.AddJsonBody("{\n \"BankName\": \"İŞ BANKASI\",\n \"Name\": \"İş Bankası TRY Hesabı\",\n \"AccountType\": 1,\n \"CurrencyCode\": \"TRY\"\n}", false);
var response = await client.PostAsync(request);
Console.WriteLine("{0}", response.Content);
const options = {
method: 'POST',
headers: {
'X-UserID': '<x-userid>',
'X-CompanyID': '<x-companyid>',
Authorization: 'Bearer <token>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
BankName: 'İŞ BANKASI',
Name: 'İş Bankası TRY Hesabı',
AccountType: 1,
CurrencyCode: 'TRY'
})
};
fetch('https://api.noyax.com/api/v1/finance/bank-accounts', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.noyax.com/api/v1/finance/bank-accounts"
payload = {
"BankName": "İŞ BANKASI",
"Name": "İş Bankası TRY Hesabı",
"AccountType": 1,
"CurrencyCode": "TRY"
}
headers = {
"X-UserID": "<x-userid>",
"X-CompanyID": "<x-companyid>",
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"Success": true,
"ResultCode": "0000",
"Data": {
"Id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"BankId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"CurrencyId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"BankName": "İŞ BANKASI",
"Name": "İş Bankası TRY Hesabı",
"BranchName": "<string>",
"BranchCode": "<string>",
"AccountNumber": "<string>",
"Iban": "<string>",
"AccountType": 1,
"CurrencyCode": "TRY",
"IsDisabled": false,
"SharingCode": "<string>"
},
"Message": "<string>"
}{
"Success": false,
"ResultCode": "8016",
"Message": "AccountType must be between 1 and 4.",
"Errors": [
{
"Code": "8016",
"Message": "AccountType must be between 1 and 4."
}
]
}{
"Success": false,
"ResultCode": "0102",
"Message": "Token has expired. Obtain a new token using the refresh token.",
"Errors": [
{
"Code": "0102",
"Message": "Token has expired. Obtain a new token using the refresh token."
}
]
}{
"Success": false,
"ResultCode": "0110",
"Message": "You do not have permission for this operation.",
"Errors": [
{
"Code": "0110",
"Message": "You do not have permission for this operation."
}
]
}{
"Success": false,
"ResultCode": "0120",
"Message": "Daily request limit (10000) exceeded.",
"Errors": [
{
"Code": "0120",
"Message": "Daily request limit (10000) exceeded."
}
]
}BankNameis required and must be one of the company’s banks.Nameis required.CurrencyCodeis required and must be one of the company’s currencies.AccountTypemust be 1 (Commercial account), 2 (Collateral account), 3 (POS account) or 4 (Credit card account — the company’s own credit card).BranchName,BranchCode,AccountNumber,Ibanare optional; their maximum lengths are in the field descriptions, values that exceed them are rejected with0003.IsDisableddefaults tofalsewhen not sent.SharingCodeis optional; when sent, it must be one of the user’s sharing codes.
Error codes
Codes this endpoint can return. The general errors that apply to every endpoint (authentication, permissions, request headers, request limits) are not repeated here.| Code | HTTP | Meaning |
|---|---|---|
0002 | 400 | Request body could not be read (malformed JSON, wrong field type), or it contains a field the endpoint does not have |
0003 | 400 | A field exceeds its maximum length (the message names the field and the limit) |
0580 | 400 | A value given as text (a code or a name) matches more than one record; add the detail that tells them apart (for example City for a district, Country for a city) |
8011 | 400 | Bank account Name is required |
8012 | 400 | BankName is required |
8013 | 400 | BankName was not found |
8014 | 400 | CurrencyCode is required |
8015 | 400 | CurrencyCode was not found |
8016 | 400 | AccountType must be between 1 and 4 |
8018 | 400 | SharingCode is not one of the user’s sharing codes |
Authorizations
Headers
Body
application/jsontext/jsonapplication/*+json
Response
Created