POST api/documents/domestic

Create a document in national currency (Individual)

Request

URI Parameters

empty

Request body parameters

documents

One or more   DomesticPayment
nameDescriptionTypeadditional info
Nomination

Description, nomination / maximum 250 characters

string

Required

PayerInn

Payer - an individual ID number, legal entity Number Taxpayer

Filled only! When making a transfer to a State Treasury account on behalf of the third person, please specify the third person's taxpayer code

string

Maximum length: 11

PayerName

Payer Name

Filled only! When making a transfer to a State Treasury account on behalf of the third person, please specify the third person's name

string

-

DispatchType

Payment method.

only for outgoing transfers! Required fields.

BULK - a standard transfer, MT103 individual transfer.

Up to 10 000 GEL is possible to use both methods. For more than 10 000 GEL only MT103

string

-

ValueDate

Value Date

date

Required

IsSalary

Optional Field, is desirable to be filled while transferring salary

Salary - "TRUE"

other Cases -"FALSE"

boolean

-

CommissionAccountNumber

Commission Account/Only For Indivdual Transfers

string

-

UniqueId

unique identifier (Guid) outside system

globally unique identifier

Required

Amount

Amount

decimal number

Required

DocumentNo

Doc N

string

Required

SourceAccountNumber

Sender Account, Transfer from / only IBAN format

string

Required

BeneficiaryAccountNumber

Beneficiary Account, Transfer To

transfer of the national currency Bank of Georgia, another bank - only IBAN-'s format.

Treasury transfers, indicated Treasury code

transfer of the foreign currency account number of the existing format

string

Required

BeneficiaryBankCode

Beneficiary Bank RTGS code / mandatory

string

-

BeneficiaryInn

Recipient - an individual ID number, legal entity Number Taxpayer

string

Maximum length: 11

CheckInn

Checking transfers within Bank of Georgia using INN

Optional Field

If “TRUE” while transferring Within Bank of Georgia, benefitiary account number will be checked additionally, using indicated INN. If beneficiary account number does not belong to the owner of indicated INN, a error will ocure.

If “FALSE” while transferring within Bank of Georgia, the transfer will be checked with standard procedure

while transferring outside Bank of Georgia the value of this field should not be “TRUE”

boolean

-

BeneficiaryName

Recipient Name

string

-

AdditionalInformation

additional info / Optional / Not used Transfer of national currency

string

-

api.documents.domestic.comments

Request formats

application/json, text/json

Sample:
[
  {
    "Nomination": "sample string 2",
    "PayerInn": "sample string 3",
    "PayerName": "sample string 4",
    "DispatchType": "sample string 5",
    "ValueDate": "2025-01-18T11:43:04.433214+04:00",
    "IsSalary": true,
    "CommissionAccountNumber": "sample string 8",
    "UniqueId": "22b70d1d-6e4a-477d-a5fe-2a0edda5b846",
    "Amount": 10.0,
    "DocumentNo": "sample string 11",
    "SourceAccountNumber": "sample string 12",
    "BeneficiaryAccountNumber": "sample string 13",
    "BeneficiaryBankCode": "sample string 14",
    "BeneficiaryInn": "sample string 15",
    "CheckInn": true,
    "BeneficiaryName": "sample string 17",
    "AdditionalInformation": "sample string 18"
  },
  {
    "Nomination": "sample string 2",
    "PayerInn": "sample string 3",
    "PayerName": "sample string 4",
    "DispatchType": "sample string 5",
    "ValueDate": "2025-01-18T11:43:04.433214+04:00",
    "IsSalary": true,
    "CommissionAccountNumber": "sample string 8",
    "UniqueId": "22b70d1d-6e4a-477d-a5fe-2a0edda5b846",
    "Amount": 10.0,
    "DocumentNo": "sample string 11",
    "SourceAccountNumber": "sample string 12",
    "BeneficiaryAccountNumber": "sample string 13",
    "BeneficiaryBankCode": "sample string 14",
    "BeneficiaryInn": "sample string 15",
    "CheckInn": true,
    "BeneficiaryName": "sample string 17",
    "AdditionalInformation": "sample string 18"
  }
]

application/xml, text/xml

Sample:
<ArrayOfDomesticPayment xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/CIBApi.Models">
  <DomesticPayment>
    <AdditionalInformation>sample string 18</AdditionalInformation>
    <Amount>10</Amount>
    <BeneficiaryAccountNumber>sample string 13</BeneficiaryAccountNumber>
    <BeneficiaryBankCode>sample string 14</BeneficiaryBankCode>
    <BeneficiaryInn>sample string 15</BeneficiaryInn>
    <BeneficiaryName>sample string 17</BeneficiaryName>
    <CheckInn>true</CheckInn>
    <Currency>GEL</Currency>
    <DocumentNo>sample string 11</DocumentNo>
    <SourceAccountNumber>sample string 12</SourceAccountNumber>
    <UniqueId>22b70d1d-6e4a-477d-a5fe-2a0edda5b846</UniqueId>
    <CommissionAccountNumber>sample string 8</CommissionAccountNumber>
    <DispatchType>sample string 5</DispatchType>
    <IsSalary>true</IsSalary>
    <Nomination>sample string 2</Nomination>
    <PayerInn>sample string 3</PayerInn>
    <PayerName>sample string 4</PayerName>
    <ValueDate>2025-01-18T11:43:04.433214+04:00</ValueDate>
  </DomesticPayment>
  <DomesticPayment>
    <AdditionalInformation>sample string 18</AdditionalInformation>
    <Amount>10</Amount>
    <BeneficiaryAccountNumber>sample string 13</BeneficiaryAccountNumber>
    <BeneficiaryBankCode>sample string 14</BeneficiaryBankCode>
    <BeneficiaryInn>sample string 15</BeneficiaryInn>
    <BeneficiaryName>sample string 17</BeneficiaryName>
    <CheckInn>true</CheckInn>
    <Currency>GEL</Currency>
    <DocumentNo>sample string 11</DocumentNo>
    <SourceAccountNumber>sample string 12</SourceAccountNumber>
    <UniqueId>22b70d1d-6e4a-477d-a5fe-2a0edda5b846</UniqueId>
    <CommissionAccountNumber>sample string 8</CommissionAccountNumber>
    <DispatchType>sample string 5</DispatchType>
    <IsSalary>true</IsSalary>
    <Nomination>sample string 2</Nomination>
    <PayerInn>sample string 3</PayerInn>
    <PayerName>sample string 4</PayerName>
    <ValueDate>2025-01-18T11:43:04.433214+04:00</ValueDate>
  </DomesticPayment>
</ArrayOfDomesticPayment>

Response

Description

დოკუმენტების იდენტიფიკატორები

One or more   DocumentKey
nameDescriptionTypeadditional info
UniqueId

unique identifier (Guid) outside system

globally unique identifier

-

UniqueKey

Unique identifier of the Business Online

integer

-

ResultCode

api.document.result.code

integer

-

Match

Match %

When making an internal transfer, if the recipient that you enter is a legal entity, such recipient will be checked against the name of the IBAN account holder with the bank, and if the recipient that you enter is a natural person, such recipient will be checked against the first name and last name of such person. The comparison will show a % result of matching.

To check for duplication when creating any documents or performing package transfers, the new document is checked to see whether it matches any of the documents already created. You can compare documents in advance according to the fields that you select.

decimal number

-

formats

application/json, text/json

Sample:
[
  {
    "UniqueId": "e4dff7e1-e592-4961-adde-478cda3e9ff1",
    "UniqueKey": 2,
    "ResultCode": 1,
    "Match": 1.0
  },
  {
    "UniqueId": "e4dff7e1-e592-4961-adde-478cda3e9ff1",
    "UniqueKey": 2,
    "ResultCode": 1,
    "Match": 1.0
  }
]

application/xml, text/xml

Sample:
<ArrayOfDocumentKey xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/CIBApi.Models">
  <DocumentKey>
    <Match>1</Match>
    <ResultCode>1</ResultCode>
    <UniqueId>e4dff7e1-e592-4961-adde-478cda3e9ff1</UniqueId>
    <UniqueKey>2</UniqueKey>
  </DocumentKey>
  <DocumentKey>
    <Match>1</Match>
    <ResultCode>1</ResultCode>
    <UniqueId>e4dff7e1-e592-4961-adde-478cda3e9ff1</UniqueId>
    <UniqueKey>2</UniqueKey>
  </DocumentKey>
</ArrayOfDocumentKey>