Skip to main content
View as Markdown

Package transfer in the foreign currency

This method allows to create one or more package documents in the national currency.

Query params​

fileNamerequiredstring

Package name

Params​

Chargesrequiredstring

A transfer method. Can take one of the following values:

  • SHA - (SWIFT) The Payer (sender of the payment) will pay only fees charged by the sending bank.
  • OUR - (SWIFT) The Payer (sender of the payment) will pay all fees charged by the sending bank.
  • BULK - (RTGS) A standard transfer. Is allowed only for up to 10 000 USD/EUR transactions.
  • MT103 - (RTGS) An individual transfer.

RTGS transfers are available only to Georgian banks in USD or EUR.

CommissionAccountNumberoptionalstring

A fees’ account number.

BeneficiaryBankNameoptionalstring

A receiver Bank name. For SWIFT transfers, it is mandatory to fill in either BeneficiaryBankCode or BeneficiaryBankName. Must be left empty for RTGS transfers.

IntermediaryBankCodeoptionalstring

A SWIFT code of an Intermediary Bank. Must be left empty for RTGS transfers.

IntermediaryBankNameoptionalstring

A name of an Intermediary Bank. Must be left empty for RTGS transfers.

PaymentDetailoptionalstring

A reason, purpose of the transfer / 4x34 (136) symbols max.

ValueDaterequireddate

A date of document entry in the bank system.

BeneficiaryRegistrationCountryCodeoptionalstring

Recipient’s registration country.

BeneficiaryActualCountryCodeoptionalstring

Recipient’s actual country.

RecipientAddressoptionalstring

Recipient’s address. Must be left empty for RTGS transfers.

RecipientCityoptionalstring

Recipient’s city. Must be left empty for RTGS transfers.

RegReportingValueoptionalstring

An additional field that is used when transferring to the UAE.

UniqueIdrequiredglobally unique identifier

An unique ID of a document in the external (caller) system (Guid).

Amountrequireddecimal number

A document’s amount.

Currencyrequiredstring

A document currency.

DocumentNorequiredstring

A document’s number.

SourceAccountNumberrequiredstring

A sender’s account in IBAN format.

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.

BeneficiaryBankCodeoptionalstring

A BIC code of a recipient Bank. Must be left empty for RTGS transfers.

BeneficiaryInnoptionalstring, max-length: 11

An 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 to False.

BeneficiaryNameoptionalstring

A recipient’s name.

AdditionalInformationoptionalstring

An additional info. Is not used for transfers in a national currency.

PurposeCodeoptionalstring

A payment purpose code. Used for currency operation reporting.

AttachmentIdsoptionalarray of string

A list of attachment hashes. Each hash (externalFileHash) is obtained from the file upload endpoint. Filled only when you want to attach files to the document.

CheckUniqueIdoptionalboolean

When true, before the document is created it is checked whether a document with the same UniqueId has already been created within the last 7 days. If a duplicate is found, no new document is created and result code 702 is returned.

POST api/documents/bulk/foreign?fileName={fileName}
Content-Type: application/json
[
  {
    "Charges": "sample string 1",
    "CommissionAccountNumber": "sample string 2",
    "BeneficiaryBankName": "sample string 3",
    "IntermediaryBankCode": "sample string 4",
    "IntermediaryBankName": "sample string 5",
    "PaymentDetail": "sample string 6",
    "ValueDate": "2021-06-17T17:55:21.9971829+04:00",
    "BeneficiaryRegistrationCountryCode": "sample string 8",
    "BeneficiaryActualCountryCode": "sample string 9",
    "RecipientAddress": "sample string 10",
    "RecipientCity": "sample string 11",
    "RegReportingValue": "sample string 12",
    "UniqueId": "16928efd-7fc0-4dd4-8643-64b4e1ae6725",
    "Amount": 14.0,
    "Currency": "sample string 15",
    "DocumentNo": "sample string 16",
    "SourceAccountNumber": "sample string 17",
    "BeneficiaryAccountNumber": "sample string 18",
    "BeneficiaryBankCode": "sample string 19",
    "BeneficiaryInn": "sample string 20",
    "CheckInn": true,
    "BeneficiaryName": "sample string 22",
    "AdditionalInformation": "sample string 23"
  },
  {
    "Charges": "sample string 1",
    "CommissionAccountNumber": "sample string 2",
    "BeneficiaryBankName": "sample string 3",
    "IntermediaryBankCode": "sample string 4",
    "IntermediaryBankName": "sample string 5",
    "PaymentDetail": "sample string 6",
    "ValueDate": "2021-06-17T17:55:21.9971829+04:00",
    "BeneficiaryRegistrationCountryCode": "sample string 8",
    "BeneficiaryActualCountryCode": "sample string 9",
    "RecipientAddress": "sample string 10",
    "RecipientCity": "sample string 11",
    "RegReportingValue": "sample string 12",
    "UniqueId": "16928efd-7fc0-4dd4-8643-64b4e1ae6725",
    "Amount": 14.0,
    "Currency": "sample string 15",
    "DocumentNo": "sample string 16",
    "SourceAccountNumber": "sample string 17",
    "BeneficiaryAccountNumber": "sample string 18",
    "BeneficiaryBankCode": "sample string 19",
    "BeneficiaryInn": "sample string 20",
    "CheckInn": true,
    "BeneficiaryName": "sample string 22",
    "AdditionalInformation": "sample string 23"
  }
]

დაბრუნებული პარამეტრები#​

integer

A unique ID of a package on the business online.

1