Individual document in the national currency
This method allows creating one or more individual documents in national currency.
Params
Nominationrequiredstring
A reason, purpose of the transfer / 250 symbols max.
PayerInnrequiredstring, max-length: 11
An Identification Number of a taxpayer individual, or an Identification Code of a legal entity. Should be filled only when a transaction is performed towards the budget on behalf of a third party (in this case an identification code of a said the third party should be filled).
PayerNameoptionalstring
A Payer's name. Should be filled only when a transaction is performed towards the budget on behalf of a third party (in this case a name of a said the third party should be filled)
DispatchTypeoptionalstring
A transfer method. Is used for outbound transfers only and is a mandatory field. Can take the following values:
- BULK – A standard transfer. Is allowed only for up to 10 000 GEL transactions.
- MT103 - An individual transfer.
ValueDaterequireddate
A date of document entry in the bank system.
IsSalaryoptionalboolean
Nonmandatory field, preferred to be filled on salary transfers:
- TRUE – In cases of a salary transfer.
- FALSE – In other cases
UniqueIdrequiredglobally unique identifier
A unique ID of an external (caller) system (Guid).
Amountrequireddecimal number
A document amount.
DocumentNorequiredstring
A document number.
SourceAccountNumberrequiredstring
An IBAN format of a sender’s account.
BeneficiaryAccountNumberrequiredstring
A recipient’s account. Only IBAN format is allowed for transfers to the Bank of Georgia or other banks in the national currency. A treasury code for the transfers to the National Treasury. An account ID in an existing format for the transfers in the foreign currency.
BeneficiaryBankCoderequiredstring
A recipient Bank’s RTGS code.
BeneficiaryInnrequiredstring
A Personal Identification Number for individuals; an Identification Code for legal entities.
CheckInnoptionalboolean
Used to indicate whether the compatibility of a receiver’s account to the Identification Code should be checked when transferring to the Bank of Georgia. Can take one of the two values:
TRUE
– An additional compatibility check of the account number by the identification code should take place. If the account number does not match the account numbers related to that identification code- an error will be returned.FALSE
– A transfer will be checked in a standard way. When transferring to another bank, this parameter should be always set toFalse
.
BeneficiaryNameoptionalstring
A recipient’s name.
AdditionalInformationoptionalstring
An additional info. Is not used for transfers in a national currency.
- JSON
- XML
POST api/documents/domestic
Content-Type: application/json
[
{
"Nomination": "sample string 2",
"PayerInn": "sample string 3",
"PayerName": "sample string 4",
"DispatchType": "sample string 5",
"ValueDate": "2021-06-17T10:31:50.2269037+04:00",
"IsSalary": true,
"UniqueId": "066a7743-256a-4b40-b937-78e241dd31ae",
"Amount": 9.0,
"DocumentNo": "sample string 10",
"SourceAccountNumber": "sample string 11",
"BeneficiaryAccountNumber": "sample string 12",
"BeneficiaryBankCode": "sample string 13",
"BeneficiaryInn": "sample string 14",
"CheckInn": true,
"BeneficiaryName": "sample string 16",
"AdditionalInformation": "sample string 17"
},
{
"Nomination": "sample string 2",
"PayerInn": "sample string 3",
"PayerName": "sample string 4",
"DispatchType": "sample string 5",
"ValueDate": "2021-06-17T10:31:50.2269037+04:00",
"IsSalary": true,
"UniqueId": "066a7743-256a-4b40-b937-78e241dd31ae",
"Amount": 9.0,
"DocumentNo": "sample string 10",
"SourceAccountNumber": "sample string 11",
"BeneficiaryAccountNumber": "sample string 12",
"BeneficiaryBankCode": "sample string 13",
"BeneficiaryInn": "sample string 14",
"CheckInn": true,
"BeneficiaryName": "sample string 16",
"AdditionalInformation": "sample string 17"
}
]
POST api/documents/domestic
Content-Type: application/xml
<ArrayOfDomesticPayment xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/CIBApi.Models">
<DomesticPayment>
<AdditionalInformation>sample string 17</AdditionalInformation>
<Amount>9</Amount>
<BeneficiaryAccountNumber>sample string 12</BeneficiaryAccountNumber>
<BeneficiaryBankCode>sample string 13</BeneficiaryBankCode>
<BeneficiaryInn>sample string 14</BeneficiaryInn>
<BeneficiaryName>sample string 16</BeneficiaryName>
<CheckInn>true</CheckInn>
<Currency>GEL</Currency>
<DocumentNo>sample string 10</DocumentNo>
<SourceAccountNumber>sample string 11</SourceAccountNumber>
<UniqueId>a9ee0b25-6d72-4774-b7d0-0c8415fe9ebf</UniqueId>
<DispatchType>sample string 5</DispatchType>
<IsSalary>true</IsSalary>
<Nomination>sample string 2</Nomination>
<PayerInn>sample string 3</PayerInn>
<PayerName>sample string 4</PayerName>
<ValueDate>2021-06-17T11:22:01.4869236+04:00</ValueDate>
</DomesticPayment>
<DomesticPayment>
<AdditionalInformation>sample string 17</AdditionalInformation>
<Amount>9</Amount>
<BeneficiaryAccountNumber>sample string 12</BeneficiaryAccountNumber>
<BeneficiaryBankCode>sample string 13</BeneficiaryBankCode>
<BeneficiaryInn>sample string 14</BeneficiaryInn>
<BeneficiaryName>sample string 16</BeneficiaryName>
<CheckInn>true</CheckInn>
<Currency>GEL</Currency>
<DocumentNo>sample string 10</DocumentNo>
<SourceAccountNumber>sample string 11</SourceAccountNumber>
<UniqueId>a9ee0b25-6d72-4774-b7d0-0c8415fe9ebf</UniqueId>
<DispatchType>sample string 5</DispatchType>
<IsSalary>true</IsSalary>
<Nomination>sample string 2</Nomination>
<PayerInn>sample string 3</PayerInn>
<PayerName>sample string 4</PayerName>
<ValueDate>2021-06-17T11:22:01.4869236+04:00</ValueDate>
</DomesticPayment>
</ArrayOfDomesticPayment>
Response
UniqueIdglobally unique identifier
An unique ID in the external system (Guid).
UniqueKeyinteger
An unique ID of the document in the business online.
ResultCodeinteger
A result code of an operation. (With a link to the ResultCode page).
result code
Matchdecimal number
For the internal transfers a matched coefficient of a provided recipient name. For legal entities a match of an owner of a provided IBAN to the entity name is being checked, while for the individuals - to the name and surname. A match coefficient in percent will be shown as a result of such a comparison.
- JSON
- XML
[
{
"UniqueId": "57adca88-0aff-4eb7-9648-4785106e77f6",
"UniqueKey": 2,
"ResultCode": 1,
"Match": 1.0
},
{
"UniqueId": "57adca88-0aff-4eb7-9648-4785106e77f6",
"UniqueKey": 2,
"ResultCode": 1,
"Match": 1.0
}
]
<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>57adca88-0aff-4eb7-9648-4785106e77f6</UniqueId>
<UniqueKey>2</UniqueKey>
</DocumentKey>
<DocumentKey>
<Match>1</Match>
<ResultCode>1</ResultCode>
<UniqueId>57adca88-0aff-4eb7-9648-4785106e77f6</UniqueId>
<UniqueKey>2</UniqueKey>
</DocumentKey>
</ArrayOfDocumentKey>