Introduction

სერვისების გამოსაძახებლად პირველ რიგში თქვენი აპლიკაცია უნდა დაარეგისტრიროთ შემდეგ გვერდზე: https://payme-business.zencode.io რეგისტრაციისას უნდა მიუთითოთ აპლიკაციის სახელი(დასახელება უცხოურ ენაზე). თუ არეგისტრირებთ კლიენტს Implicit ან Authorization Code Flow-ს მიხედვით, მაშინ ასევე უნდა მიუთითო გადამისამართების მისამართი რომელზეც მოხდება გადამისამართება აუტენტიფიკაციის დროს.

Implicit Flow

1. მაგალითად, თუ თქვენი აპლიკაციის client id არის 55A77637-D297-4960-BB2D-D5036B36B6B0, ხოლო redirect uri არის https://payme.zencode.io მაშინ ამ მისამართს ექნება ასეთი სახე (url კოდირებამდე): https://payme-idp.zencode.io/Identity/Account/Login?ReturnUrl=/connect/authorize/callback?client_id=55A77637-D297-4960-BB2D-D5036B36B6B0&redirect_uri=https://payme.zencode.io&response_type=token&scope=corp ხოლო url ენკოდირების (encodeURIComponent) შემდეგ url იქნებ ესეთი https://payme-idp.zencode.io/Identity/Account/Login?ReturnUrl=%2Fconnect%2Fauthorize%2Fcallback%3Fclient_id%3D55A77637-D297-4960-BB2D-D5036B36B6B0%26redirect_uri%3Dhttps%3A%2F%2Fpayme.zencode.io%26response_type%3Dtoken%26scope%3Dcorp
   • client_id - თქვენი აპლიკაციის client id
   • response_type - "token"
   • scope - "corp"
   • redirect_uri - თქვენი აპლიკაციის redirect uri
   • kc_locale - ინტერფეისის ენა: ka -ქართული ენის შემთხვევაში, ამ პარამეტრის გარეშე ინგლისური ენის შესაბამისი ინტერფეისი გამოჩნდება
2. მომხმარებელი გადამისამართდება redirect_uri მისამართზე, შემდეგი პარამეტრებით query string format ში:
   • access_token - დროებითი ტოკენი
   • expires_in - ამოწურვის დრო
   • token_type - ტოკენის ტიპი

ამის შემდეგ თქვენ შეგიძლიათ გამოიძახოთ სერვისები დაბრუნებული access_token-ის გამოყენებით. ამისათვის თქვენს მოთხოვნებს უნდა დაამატოთ Authorization Header ასეთი სახით: Authorization: Bearer Ing1dCI6ImEzck1VZ01Gdjl0UGNsTGE2eUYzekFrZnF1RSJ9.eyJpc.....

Authorization code flow

1. მაგალითად, თუ თქვენი აპლიკაციის client id არის AEE66486-A0B1-475C-9F16-F6CD4ADABB07, ხოლო redirect uri არის https://payme.zencode.io მაშინ ამ მისამართს ექნება ასეთი სახე (url კოდირებამდე): https://payme-idp.zencode.io/Identity/Account/Login?ReturnUrl=/connect/authorize/callback?client_id=AEE66486-A0B1-475C-9F16-F6CD4ADABB07&redirect_uri=https://payme.zencode.io&response_type=code&scope=corp ხოლო url ენკოდირების (encodeURIComponent) შემდეგ url იქნებ ესეთი https://payme-idp.zencode.io/Identity/Account/Login?ReturnUrl=%2Fconnect%2Fauthorize%2Fcallback%3Fclient_id%3DAEE66486-A0B1-475C-9F16-F6CD4ADABB07%26redirect_uri%3Dhttps%3A%2F%2Fpayme.zencode.io%26response_type%3Dcode%26scope%3Dcorp
   • client_id - თქვენი აპლიკაციის client id
   • response_type - "code"
   • scope - "corp"
   • redirect_uri - თქვენი აპლიკაციის redirect uri
   • kc_locale - ინტერფეისის ენა: ka -ქართული ენის შემთხვევაში, ამ პარამეტრის გარეშე ინგლისური ენის შესაბამისი ინტერფეისი გამოჩნდება
2. მომხმარებელი დაადასტურებს აპლიკაციის მოთხოვნას, ანუ გაივლის ავტორიზციას
3. მომხმარებელი გადამისამართდება redirect_uri მისამართზე, შემდეგი პარამეტრებით query string format -ში:
   • code - დროებითი კოდი
4. გააგზავნოთ POST მოთხოვნა შემდეგ მისამართზე: https://payme-idp.zencode.io/connect/token შემდეგი პარამეტრებით მოთხოვნის ტანში, application/x-www-form-urlencoded Content-Type-ით:
   • grant_type - authorization_code
   • code - დროებითი კოდი
   • redirect_uri - თქვენი აპლიკაციის redirect uri
   • client_id - თქვენი აპლიკაციის client_id
   • client_secret - თქვენი აპლიკაციის client_secret

ამის შემდეგ თქვენ შეგიძლიათ გამოიძახოთ სერვისები დაბრუნებული access_token-ის გამოყენებით. ამისათვის თქვენს მოთხოვნებს უნდა დაამატოთ Authorization Header ასეთი სახით: Authorization: Bearer IsIng1dCI6ImEzck1VZ01Gdjl0UGNsTGE2eUYzekFrZnF1RSJ9.eyJpc....

Client crerdentials flow

გააგზავნეთ POST მოთხოვნა შემდეგ მისამართზე: https://payme-idp.zencode.io/connect/token შემდეგი პარამეტრებით მოთხოვნის ტანში, application/x-www-form-urlencoded Content-Type-ით:

• grant_type - "client_credentials"
• client_id - თქვენი აპლიკაციის client_id
• client_secret - თქვენი აპლიკაციის client_secret

ამის შემდეგ თქვენ შეგიძლიათ გამოიძახოთ სერვისები დაბრუნებული access_token-ის გამოყენებით. ამისათვის თქვენს მოთხოვნებს უნდა დაამატოთ Authorization Header ასეთი სახით: Authorization: Bearer ng1dCI6ImEzck1VZ01Gdjl0UGNsTGE2eUYzekFrZnF1RSJ9.eyJpc.......

The Documents RESTful API allows you to create, transfer, and query documents. The API supports creating single or batch documents, getting the status of single or multiple documents, and filtering the results by various criteria. The API uses JSON format to represent the document and bulk operation details and statuses.