Skip to main content

Send Payment Info

The send-payment-info operation will be executed once at the end of the day and will send information about successful payments that took place the day before the request (span of 24 hours), according to the UTC+4h (Tbilisi) time zone.

Since the request body contains both the summary & individual information about payments, there is a risk that the request body might reach a size limit. Because of this, the send-payment-info operation will be executed in batches, where the timespan of nth batch starts at Tn (inclusive), and the timespan of n-1th batch ends at Tn (inclusive), where Tn-1 < Tn. I.e. batches will be sent subsequently based on subsets of a 24 hour timespan. Moreover, in case of failure to send the data per batch, a retry will be attempted once.

Body Parameters​

timezoneIdrequiredstring

Time Zone Identifier.

timespan.fromnumber

(Inclusive) UNIX timestamp – the amount of milliseconds that have passed since January 1st, 1970 at UTC.

timespan.tonumber

(Exclusive) UNIX timestamp – the amount of milliseconds that have passed since January 1st, 1970 at UTC.

summary[?].totalAmountrequiredstring

Amount in minor units (e.g. Georgian Tetri, American Cent, etc.).

summary[?].currencyCoderequiredstring

Currency

summary[?].countrequiredstring

ტრანზაქციების რაოდენობა.

paymentList[?].transactionIdrequiredstring

An unique transaction identifier, created by BOG.

paymentList[?].currencyCoderequiredstring

Currency

paymentList[?].amountrequiredstring

Amount in minor units (e.g. Georgian Tetri, American Cent, etc.).

{
   "timezoneId": "Asia/Tbilisi",
   "timespan": {
     "from": 1693598400000,
     "to": 1693684799000
   },
   "summary": [
     {
        "totalAmount": 5000000,
        "currency": "GEL",
        "count": 2
     },
     {
        "totalAmount": 100000,
        "currency": "USD",
        "count": 1
     }
   ],
   "paymentList":[
     {
        "transactionId": "00000000",
        "currencyCode": "GEL",
        "amount": 2500000
     },
     {
        "transactionId": "00000001",
        "currencyCode": "GEL",
        "amount": 2500000
     },
     {
        "transactionId": "00000002",
        "currencyCode": "USD",
        "amount": 100000
     }
   ]
}

Response​

The service-provider must answer in the following JSON format:

status.codenumber

Refers to the pre-defined status codes.

status.valuestring

Status value (optional)

timestampnumber

UNIX timestamp – the amount of milliseconds that have passed since January 1st, 1970 at UTC.

{
   "status":{
      "code":0,
      "value":"OK"
   },
   "timestamp":1693236686855
}