Skip to main content

არჩევითი ოპერაციები

NOTICE

მორგებული ოპერაციები არჩევითია. ე.ი. სერვის-პროვაიდერმა შეიძლება საერთოდ არ განსაზღვროს რაიმე ოპერაცია.

ცვლადების სავალდებულო სტანდარტები​

კომპანიის მასშტაბით სტანდარტების შესანარჩუნებლად, BOG მოითხოვს, რომ სერვის-პროვაიდერებმა გამოიყენონ კონკრეტული ცვლადის სახელები, რომლებიც შეესაბამება მათ მნიშვნელობებს. Მაგალითად. თუ მომხმარებელი იყენებს თავის პირად ნომერს სერვის-პროვაიდერისგან გარკვეული ინფორმაციის მისაღებად (მაგ. დავალიანება), მაშინ ამ უკანასკნელმა უნდა გამოიყენოს personalNumber, როგორც API-ს მიერ მოთხოვნილი ცვლადის სახელი.

იხილეთ სავალდებულო ცვლადების სტანდარტების სრული სია ქვემოთ:

  • personalNumber – გამოიყენება როგორც პირადი ნომრის იდენტიფიკატორი.
  • customerId – გამოიყენება როგორც მომხმარებლის იდენტიფიკატორი.
  • debt – მომხმარებელმა მომსახურების მიმწოდებლის მიმართ მცირე ერთეულებით დავალიანება.
  • debtList – მონაცემთა მოდელების სია, რომელიც შეიცავს კლიენტის მიერ მომსახურების მიმწოდებლისადმი კუთვნილ თანხებს (და შესაძლოა სხვა ველებს) მცირე ერთეულებში.
  • amount – თანხა, რომელიც მომხმარებელს სურს გადაიხადოს მცირე ერთეულებით.

მონაცემთა გაცვლის ფორმატი​

ყველა მორგებული ოპერაცია, რომელიც დაუკავშირდება სერვის-პროვაიდერის API-ს, გაგზავნის ყველა მოთხოვნის პარამეტრს, როგორც HTTP Query პარამეტრებს, ასევე HTTP Header-ის მნიშვნელობებს, რომლებიც გამოიყენება ავტორიზაციისთვის. სერვის-პროვაიდერმა კი, თითოეულ ოპერაციას უნდა უპასუხოს წინასწარ განსაზღვრული ფორმატით:

status.codenumber

წინასწარ განსაზღვრული სტატუსის კოდი.

status.valuestring

სტატუსის მნიშვნელობა (სურვილისამებრ).

timestampnumber

UNIX დროის შტამპი – მილიწამების რაოდენობა, რაც გავიდა 1970 წლის 1 იანვრიდან დღემდე UTC-ის დროის სარტყელით.

receiptIdstring

receiptId არის გადახდის უნიკალური იდენტიფიკატორი, რომელიც დაბრუნდა სერვის-პროვაიდერისგან წარმატებული გადახდის ოპერაციის შემდეგ.

responseobject

JSON მონაცემები - დაბრუნებული ნებისმიერი თვითნებური ოპერაციიდან. ველი სავალდებულოა ყოველი ოპერაციისთვის.

{
   "status":{
      "code":0,
      "value":"OK"
   },
   "timestamp":1693236686855,
   "receiptId":"",
   "response":{"wrapper":{"categoryCodes":["A1","B"]}}
}
note

სერვის-პროვაიდერის მიერ შექმნილ ოპერაციებთან ერთად, ასევე არსებობს BOG-ის მიერ წინასწარ განსაზღვრული ოპერაციები, რომელთაგან საჭიროა მხოლოდ გადახდის ოპერაცია, ყველა დანარჩენი არასავალდებულოა.