# Bank of Georgia developer documentation > Documentation for the public API services of Bank of Georgia: online payments, payment links, billing, online instalments, business internet banking and open banking. Every page listed here is also available as Markdown — append `.md` to its URL (for example `/docs/en/payments/introduction.md`). The whole documentation as a single file: `/docs/en/llms-full.txt`. Georgian version: `/docs/llms.txt`. ## Payment Manager The online payments API: creating an order, callbacks, refunds, saved cards, pre-authorisation, Google Pay and Apple Pay. - [Introduction](https://api.bog.ge/docs/en/payments/introduction.md): The Online Payment API is a robust, developer-friendly solution designed to integrate a secure payment module into any electronic system quickly and effortlessly. It streamlines p… - [Authentication Method](https://api.bog.ge/docs/en/payments/authentication.md): To use the payment API, HTTP Basic Auth is required. You will need to know the unique credentials of your business to enter the system. These credentials consist of two parameters… ### Standard Process - [Order Request](https://api.bog.ge/docs/en/payments/standard-process/create-order.md): To place an order request, businesses must send payment details, technical specifications, and the amount to be paid to the online payment server. If the process is successful, th… - [Payment Details](https://api.bog.ge/docs/en/payments/standard-process/get-payment-details.md): This method allows businesses to receive detailed information about an online payment using its identifier. - [Callback](https://api.bog.ge/docs/en/payments/standard-process/callback.md): A callback is an asynchronous, server-to-server notification sent from the online payment system to your designated callback URL. Its purpose is to reliably inform your system abo… ### Save Card - [Save Card for Recurring Payments](https://api.bog.ge/docs/en/payments/saved-card/recurrent.md): The bank offers businesses the option to save a customer's card information, with the customer's consent, to enable future payments without having to enter card details again. - [Save Card for Automatic Payments](https://api.bog.ge/docs/en/payments/saved-card/offline.md): The bank offers businesses the option to save a customer's card information, with the customer's consent, so that it can withdraw the amount automatically, without the customer's… - [Delete Saved Card](https://api.bog.ge/docs/en/payments/saved-card/delete.md): This method allows businesses to delete previously saved card information from the system. - [Payment by the Saved Card](https://api.bog.ge/docs/en/payments/saved-card/recurrent-payment.md): This method allows businesses to enable customers to make payments on the bank's webpage without entering their card details again. This feature is useful when a customer has prev… - [Automatic Payment by the Saved Card](https://api.bog.ge/docs/en/payments/saved-card/offline-payment.md): This method enables businesses to automatically withdraw funds from a customer's saved card without their participation. This feature is useful when a customer has previously save… ### Complete Pre-Authorization - [Introduction](https://api.bog.ge/docs/en/payments/preauthorization/introduction.md): These methods allow businesses to complete the withdrawal process for the amount that was previously blocked during the order request These methods are useful if the value of the… - [Confirm Pre-Authorization](https://api.bog.ge/docs/en/payments/preauthorization/approve.md): This method allows businesses to confirm pre-authorized amounts, either in full or partially. - [Reject Pre-Authorization](https://api.bog.ge/docs/en/payments/preauthorization/reject.md): This method allows businesses to reject pre-authorized amounts in full. ### Pay From Business' Webpage - [Online Installment Plan Modal](https://api.bog.ge/docs/en/payments/external-orders/modal.md): Integration of the installment plan model is necessary only in the case, if you want a consumer to choose the installment plan conditions on your page. - [Google Pay™ on Business' Webpage](https://api.bog.ge/docs/en/payments/external-orders/external-googlepay.md): To add Google Pay™ button on your webpage, following steps are required. - [Apple Pay™ on Business' Webpage](https://api.bog.ge/docs/en/payments/external-orders/external-applepay.md): To add Apple Pay™ button on your webpage, following steps are required. - [Apple Pay™ Accept Payment](https://api.bog.ge/docs/en/payments/external-orders/complete-external-applepay.md): Calling this service is required to complete Apple Pay™ payment initiated on business' webpage. - [Refund](https://api.bog.ge/docs/en/payments/refund.md): This method allows merchants to refund the order amount either fully or partially. Full and partial refunds are supported for payments made via card, Apple Pay, Google Pay, BOG au… - [Response Codes](https://api.bog.ge/docs/en/payments/response-codes.md) - [Split Payment](https://api.bog.ge/docs/en/payments/split-payment.md): The Split Payment functionality allows you to easily and automatically distribute the amount received from an order among your partners, service providers, or merchants. - [Google Pay™](https://api.bog.ge/docs/en/payments/googlepay.md): Google Pay™ is the fast, simple way that allows you to make card payments without entering card details for each payment. The card data is safely stored by Google. - [Terms Used](https://api.bog.ge/docs/en/payments/terms-used.md): 1. Business - a retailer or service company, having an online/electronic system. 2. Online Payments Page - an online payments system, that allows you to easily build a payments' m… ## Payment Manager: top-ups Top-up and original credit transfer (OCT) methods layered on top of the Payment Manager. - [Authentication Method](https://api.bog.ge/docs/en/payments-addons/authentication.md): To use the payment API, HTTP Basic Auth is required. You will need to know the unique credentials of your business to enter the system. These credentials consist of two parameters… ### Standard Process - [Top-Up](https://api.bog.ge/docs/en/payments-addons/standard-process/create-top-up-order.md): This method allows business to initiate the top-up operation by sending the technical specifications along with the amount to be paid. To complete the payment, the customer should… - [Top-Up By Saved Card](https://api.bog.ge/docs/en/payments-addons/standard-process/create-top-up-order-with-saved-card.md): This method allows business to initiate the top-up operation using customer's already saved card, by sending the technical specifications along with the amount to be paid. To comp… - [Delete Saved Card](https://api.bog.ge/docs/en/payments-addons/standard-process/delete.md): This method allows the business to delete previously saved card information from the system. - [Payout](https://api.bog.ge/docs/en/payments-addons/standard-process/original-credit-transaction.md): This method allows the business to enable customers to make payout operations on previously saved cards. This feature is useful when a customer has previously saved their card inf… - [Refund](https://api.bog.ge/docs/en/payments-addons/standard-process/refund.md): This method allows merchants to refund the order amount either fully or partially. Full and partial refunds are supported for payments made via card, Apple Pay and BOG authorizati… - [Payment Details](https://api.bog.ge/docs/en/payments-addons/standard-process/get-payment-details.md): This method allows businesses to receive detailed information about an online payment using its identifier. - [Callback](https://api.bog.ge/docs/en/payments-addons/standard-process/callback.md): A callback is an asynchronous, server-to-server notification sent from the online payment system to your designated callback URL. Its purpose is to reliably inform your system abo… ### Pay From Business' Webpage - [Apple Pay™ on Business' Webpage](https://api.bog.ge/docs/en/payments-addons/external-orders/external-applepay.md): To add Apple Pay™ button on your webpage, following steps are required. - [Apple Pay™ Accept Payment](https://api.bog.ge/docs/en/payments-addons/external-orders/complete-external-applepay.md): Calling this service is required to complete Apple Pay™ payment initiated on business' webpage. - [Response Codes](https://api.bog.ge/docs/en/payments-addons/response-codes.md) - [Terms Used](https://api.bog.ge/docs/en/payments-addons/terms-used.md): 1. Business - a retailer or service company, having an online/electronic system. 2. Online Payments Page - an online payments system, that allows you to easily build a payments' m… ## Link Payment Creating and managing payment links through the API. - [Introduction](https://api.bog.ge/docs/en/link-payment/introduction.md): The Bank of Georgia's Online Payment API offers a simple and secure method to integrate payment processing into digital platforms. Link Payment API allows merchants to create uniq… - [Authentication and Authorization](https://api.bog.ge/docs/en/link-payment/authentication.md): This method allows businesses to undergo the authentication process. Upon calling the API, the online payment server returns the Bearer Token, which is the necessary authenticatio… - [Conventions & Common Headers](https://api.bog.ge/docs/en/link-payment/conventions.md) ### Link Payment API - [Create Pre-order](https://api.bog.ge/docs/en/link-payment/link-payment-api/create-pre-order.md): The create pre-order endpoint generates a unique payment link based on the provided transaction details. This link redirects the customer to a secure, bank-hosted page where they… - [Get Pre-Order Detail](https://api.bog.ge/docs/en/link-payment/link-payment-api/get-pre-order-detail.md): This endpoint retrieves the current status and detailed information for a specific pre-order that has already been created. By providing the unique pre_order_id, a merchant can ch… - [deactivate-pre-order](https://api.bog.ge/docs/en/link-payment/link-payment-api/deactivate-pre-order.md): This endpoint allows a merchant to deactivate an active payment link before its scheduled expiration time. Once deactivated, the link will no longer be valid, and the customer wil… - [refund-pre-order](https://api.bog.ge/docs/en/link-payment/link-payment-api/refund-pre-order.md): This endpoint initiates a refund for a previously completed transaction associated with a specific pre-order. The process is asynchronous, meaning the API confirms receipt of the… - [Callback](https://api.bog.ge/docs/en/link-payment/callback.md): A callback is an asynchronous, server-to-server notification sent from the payment system to your designated callback_url. Its purpose is to reliably inform your system about the… - [Terms Used](https://api.bog.ge/docs/en/link-payment/glossary.md): 1. Client Credentials — OAuth 2.0 flow where the client authenticates as itself 2. Idempotency — Safe retry mechanism that prevents duplicate side effects 3. TTL — Time to Live; m… ## Billing The billing gateway for providers: authentication methods, pre-defined operations and error handling. - [Introduction](https://api.bog.ge/docs/en/paymentgateway/introduction.md): The document is intended for service-providers. - [Authentication](https://api.bog.ge/docs/en/paymentgateway/authentication.md): This section defines different types of authentication methods supported by the BOG protocol. It is mandatory that a service-provider uses one of the authentication methods listed… ### Authentication Methods - [HTTP Basic](https://api.bog.ge/docs/en/paymentgateway/auth-methods/basic.md): If the service-provider chooses to use the HTTP Basic Auth authentication method, then the former must accept the Authorization header whose value follows the Basic authentication… - [OAuth 2.0 - Client Credentials](https://api.bog.ge/docs/en/paymentgateway/auth-methods/oauth2.md): The service-provider may create an authorization web-service, which supports the OAuth 2.0 (D. Hardt, Ed., 2012) Client Credentials grant type. BOG will use an HTTP POST request m… - [API Key](https://api.bog.ge/docs/en/paymentgateway/auth-methods/apikey.md): The service-provider may provide BOG with an API Key that will be used within each operation. If the key is given, then each operation will contain a header with the format: - [HMAC-SHA256](https://api.bog.ge/docs/en/paymentgateway/auth-methods/hmac-sha256.md): The service-provider can additionally provide BOG with a secret key for hashing, which will be used for hashing the request body for HTTP POST & PATCH requests, or in the case of… - [Custom Operations](https://api.bog.ge/docs/en/paymentgateway/operations.md): Custom operations are optional. I.e. the service-provider may not define any custom operations at all. ### Pre-Defined Operations - [Payment](https://api.bog.ge/docs/en/paymentgateway/pre-defined-ops/payment.md): Any number of operations can be defined by the service provider, howbeit, the payment operation with the key payment will always be executed at the end of the operation chain if t… - [Payment Status](https://api.bog.ge/docs/en/paymentgateway/pre-defined-ops/payment-status.md): When the payment-status operation is invoked by BOG, the service-provider is expected to respond with one of the following status codes: 12, 13, 14. - [Cancel Payment](https://api.bog.ge/docs/en/paymentgateway/pre-defined-ops/cancel-payment.md): When invoking the cancel-payment operation, the service-provider is expected to cancel the payment with the given transaction identifier from BOG. - [Send Payment Info](https://api.bog.ge/docs/en/paymentgateway/pre-defined-ops/send-payment-info.md): 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… - [Expected Response Times](https://api.bog.ge/docs/en/paymentgateway/expected-response-times.md): The expected response times, or the response time limits for each operation, are defined below. - OAuth Client Credentials – 15 seconds. - Custom Operations – 10 seconds. - Paymen… - [Definitions, Acronyms & Abbreviations](https://api.bog.ge/docs/en/paymentgateway/terms-used.md) - [Exception Cases](https://api.bog.ge/docs/en/paymentgateway/error-flow.md): This section contains information regarding the different routes the BOG payment system could take depending on the given circumstances within the payment operation. Keep in mind,… - [Error Codes](https://api.bog.ge/docs/en/paymentgateway/error-codes.md): A Service-provider may also introduce other error codes not listed in this table. Such codes must not be within 0-99 range. ## Online Installment Online instalments and buy-now-pay-later: the calculator, creating an order, callbacks and plugins. - [Authentication](https://api.bog.ge/docs/en/installment/authentication.md): An HTTP Basic Authentication is needed to use an Installment Loan API. To do so, you need to know the credentials for accessing the system which is unique for each Merchant. - [Callback](https://api.bog.ge/docs/en/installment/callback.md): Unlike the previous methods which are called by the Online Shop, Callback is called by an Online Installment loan System, while the information should be received and processed on… - [Order Request](https://api.bog.ge/docs/en/installment/create-order.md): By calling this method an Online Shop sends the payments details, technical parameters, and a payment amount to an Installment Loan Server. To proceed further in case of the succe… - [Control Panel](https://api.bog.ge/docs/en/installment/dashboard.md): We created a panel for controlling the Bank of Georgia’s online installment loan. This control panel is a web application in which User logs in with the internet banking credentia… - [Installment Loan Calculator](https://api.bog.ge/docs/en/installment/get-discounts.md): Before requesting an order, a customer must choose the installment loan duration and the discount method. Thus before calling the Order Request service, you should use a calculati… - [Installment Loan Details Receiving](https://api.bog.ge/docs/en/installment/installment-details.md): By calling this method an Online Shop can receive detailed information regarding the status of an installment loan completed by a customer based on the payment identifier. - [Introduction](https://api.bog.ge/docs/en/installment/introduction.md): Ipay integration is no longer available. To integrate Bank of Georgia payment methods, please use the Payment Manager technical documentation. - [An Online Installment Loan Module](https://api.bog.ge/docs/en/installment/modal.md): We created a dedicated module to support selecting the terms of the online installment loan. The module in essence is a loan calculator where a customer may check the approximate… - [Plugins and Technical Support](https://api.bog.ge/docs/en/installment/plugins.md): You do not necessarily have to be an experienced developer to establish an installment loan integration. Bank of Georgia cooperates with partner organizations that offer a product… - [Regulations and Limitations](https://api.bog.ge/docs/en/installment/regulation.md): Before familiarization with the regulations and limitations, it is crucial to distinguish two important conditions which apply to the person who takes an installment loan in the p… - [Glossary](https://api.bog.ge/docs/en/installment/terms-used.md) ## Business Internet Banking B2B banking services: authentication, statements, transfers, documents, signing and deposits. - [Available Balance](https://api.bog.ge/docs/en/bonline/accounts.md): This method allows retrieving a current and an available balance of a bank account. ### auth - [Authentication](https://api.bog.ge/docs/en/bonline/auth/auth-introduction.md): There are three methods of authentication available: - For a desktop application - For a web application - Using token - [For a desktop application](https://api.bog.ge/docs/en/bonline/auth/desktop-authentication.md): Authentication for a desktop application is done as follows: - [Authentification using token](https://api.bog.ge/docs/en/bonline/auth/token-authentication.md): Send POST request to the following address:https://account.bog.ge/auth/realms/bog/protocol/openid-connect/token with these parameters in request body and application/x-www-form-ur… - [Authentification for a web application](https://api.bog.ge/docs/en/bonline/auth/web-authentication.md): An authentification for a web application is done as follows: - [საბალანსო უწყისის ატვირთვის მეთოდი](https://api.bog.ge/docs/en/bonline/balance-sheet.md): საწყისი თარიღი ### deposits - [Deposits list](https://api.bog.ge/docs/en/bonline/deposits/agreements.md): This method allows retrieving the list of active deposits. No parameters are passed. - [Deposit amounts by currency](https://api.bog.ge/docs/en/bonline/deposits/available-amount.md): This method allows retrieving the total amounts of deposits summed by currency. No parameters are passed. ### documents - [Cancellation of a Package Transfer](https://api.bog.ge/docs/en/bonline/documents/bulk-delete.md): This method allows you to cancel a package. This means that all documents inside the package will be canceled. - [Package transfer in the national currency](https://api.bog.ge/docs/en/bonline/documents/bulk-domestic.md): This method allows to create one or more package document in national currency. - [Package transfer in the foreign currency](https://api.bog.ge/docs/en/bonline/documents/bulk-foreign.md): This method allows to create one or more package documents in the national currency. - [Package transfer status](https://api.bog.ge/docs/en/bonline/documents/bulk-status.md): This method allows retrieving the status of a document package and all individual documents status by a package unique ID. - [Conversion](https://api.bog.ge/docs/en/bonline/documents/conversion.md): This method allows creating one or more documents of conversion between customers’ accounts. - [Document creation codes](https://api.bog.ge/docs/en/bonline/documents/document-codes.md): This method allows retrieving all the document creation codes with the description. - [Cancellation of an individual document](https://api.bog.ge/docs/en/bonline/documents/document-delete.md): This method allows canceling an individual document. - [Individual document in the national currency](https://api.bog.ge/docs/en/bonline/documents/domestic.md): This method allows creating one or more individual documents in national currency. - [Individual document in the foreign currency](https://api.bog.ge/docs/en/bonline/documents/foreign.md): This method allows creating one or more individual documents in foreign currency. - [Individual document status](https://api.bog.ge/docs/en/bonline/documents/status.md): This method allows retrieving a document status by its unique ID. - [Individual document statuses](https://api.bog.ge/docs/en/bonline/documents/statuses.md): This method allows retrieving documents’ statuses by their unique IDs. - [Current day activities](https://api.bog.ge/docs/en/bonline/documents/todayactivities.md): This method allows us to retrieve all activities of the current day. ### files - [File upload](https://api.bog.ge/docs/en/bonline/files/upload.md): This method allows uploading a file. The file is sent as multipart/form-data, using the file field. - [Postman Collections (NEW!)](https://api.bog.ge/docs/en/bonline/introduction-token.md): To help you get started quickly and follow API best practices, we provide ready-to-use Postman collections covering all endpoints with full configuration. - [Introduction](https://api.bog.ge/docs/en/bonline/introduction.md): The API allows you to easily embed a functionality existing in the Bank of Georgia’s Internet Banking into your accounting or other business application. simplifying everyday oper… ### money-request - [Money request creation](https://api.bog.ge/docs/en/bonline/money-request/create.md): This method allows creating a money request. The request is sent to the recipient, who confirms the transfer. ### otp - [OTP Request](https://api.bog.ge/docs/en/bonline/otp/request.md): Object Identifier ### rates - [Bank’s commercial currency exchange rate](https://api.bog.ge/docs/en/bonline/rates/commercial-currency.md): This method allows retrieving a current commercial currency exchange rate by a Bank of Georgia for a given currency to a Georgian Lari and vice versa. - [Cross Rate](https://api.bog.ge/docs/en/bonline/rates/commercial-sellCurrency-buyCurrency.md): მეთოდის საშუალებით შესაძლებელია საქართველოს ბანკში გასაყიდი ვალუტის, საყიდელ ვალუტასთან მიმართებაში კომერციული კურსის გაგება. - [Cross Rate](https://api.bog.ge/docs/en/bonline/rates/cross-rates.md): This method returns the Bank of Georgia digital-channel rate of the sell currency against the buy currency. The base currency is returned together with the rate. - [National Bank’s currency exchange rate history](https://api.bog.ge/docs/en/bonline/rates/nbg-hist.md): This method allows retrieving an exchange rate by National Bank for a requested currency to a Georgian Lari by a period. A method returns a currency exchange rate for each date wi… - [A currency rate of the National Bank for a given currency](https://api.bog.ge/docs/en/bonline/rates/nbg.md): This method allows retrieving a current exchange rate by National Bank for a requested currency to a Georgian Lari. - [Currency rate details](https://api.bog.ge/docs/en/bonline/rates/rate-details.md): This method returns, in a single request, the full set of rates for a requested currency against the Georgian Lari: the National Bank rate, the standard buy/sell rate and the digi… ### result - [Bulk Transfer Statuses](https://api.bog.ge/docs/en/bonline/result/bulk-transfer-statuses.md): <… - [Document Statuses](https://api.bog.ge/docs/en/bonline/result/document-statuses.md):
Status Description
N Processing
Status Description
C Cancelled by Resp… - [Error Codes](https://api.bog.ge/docs/en/bonline/result/reject-codes.md):
Code Description
22 Canceled, please c… - [Result Codes](https://api.bog.ge/docs/en/bonline/result/result-codes.md): … ### sign - [Document Sign](https://api.bog.ge/docs/en/bonline/sign/document.md): OTP ### statement - [Statement entries on the page](https://api.bog.ge/docs/en/bonline/statement/paging.md): This method allows retrieving 1000 entries for an already generated account statement. - [Statement entries on the page](https://api.bog.ge/docs/en/bonline/statement/pagingV2.md): This method is used to retrieve bank statement records for a specified account in stages (pages). The service processes the request in real time and returns a detailed list of tra… - [Statement generation](https://api.bog.ge/docs/en/bonline/statement/statement.md): This method allows to generate an account statement for a certain account, certain period and retrieves no more than 1000 records. - [Statement generation](https://api.bog.ge/docs/en/bonline/statement/statementV2.md): The service provides bank statement for the specified account within the selected period. - [Statement with revaluation](https://api.bog.ge/docs/en/bonline/statement/statementV2Revaluation.md): The service provides bank statement for the specified account within the selected period, including revaluation records. To retrieve revaluation records, set the revaluation=true… - [Statement global and daily balances](https://api.bog.ge/docs/en/bonline/statement/summary.md): This method allows retrieving summary info for certain accounts by an ID returned during generation. The method retrieves summary info in total and by day. - [Statement global and daily balances](https://api.bog.ge/docs/en/bonline/statement/summaryV2.md): This method allows to view the total summary information for a specific account's statement. The method returns the full summary information, as well as the information broken dow… - [Current day activities](https://api.bog.ge/docs/en/bonline/statement/todayactivities.md): This method allows us to retrieve all activities of the current day. ## Identity Assurance Open banking identity and authentication assurance services. - [process](https://api.bog.ge/docs/en/obidentity/process.md): This documentation describes how to integrate your application with the Open Finance Identity Assurance service. The service enables one financial institution (hereinafter “Relyin… - [technical-information](https://api.bog.ge/docs/en/obidentity/technical-information.md): https://account-ob-test.bog.ge/auth/realms/bog-test/.well-known/ob-openid-configuration ## Sandbox: payments The test environment for the Payment Manager, including the test cards. - [Introduction](https://api.bog.ge/docs/en/sandbox/payments/introduction.md): The Sandbox environment is an isolated testing space that allows you to safely integrate and validate your ecommerce payment flows using the Online Payment API without processing… - [Authentication Method](https://api.bog.ge/docs/en/sandbox/payments/authentication.md): To use the payment API, HTTP Basic Auth is required. You will need to know the unique credentials of your business to enter the system. These credentials consist of two parameters… ### Standard Process - [Order Request](https://api.bog.ge/docs/en/sandbox/payments/standard-process/create-order.md): To place an order request, businesses must send payment details, technical specifications, and the amount to be paid to the online payment server. If the process is successful, th… - [Payment Details](https://api.bog.ge/docs/en/sandbox/payments/standard-process/get-payment-details.md): This method allows businesses to receive detailed information about an online payment using its identifier. - [Callback](https://api.bog.ge/docs/en/sandbox/payments/standard-process/callback.md): A callback is an asynchronous, server-to-server notification sent from the online payment system to your designated callback URL. Its purpose is to reliably inform your system abo… ### Saved Card - [Save Card for Recurring Payments](https://api.bog.ge/docs/en/sandbox/payments/saved-card/recurrent.md): The bank offers businesses the option to save a customer's card information, with the customer's consent, to enable future payments without having to enter card details again. - [Save Card for Automatic Payments](https://api.bog.ge/docs/en/sandbox/payments/saved-card/offline.md): The bank offers businesses the option to save a customer's card information, with the customer's consent, so that it can withdraw the amount automatically, without the customer's… - [Delete Saved Card](https://api.bog.ge/docs/en/sandbox/payments/saved-card/delete.md): This method allows businesses to delete previously saved card information from the system. - [Payment by the Saved Card](https://api.bog.ge/docs/en/sandbox/payments/saved-card/recurrent-payment.md): This method allows businesses to enable customers to make payments on the bank's webpage without entering their card details again. This feature is useful when a customer has prev… - [Automatic Payment by the Saved Card](https://api.bog.ge/docs/en/sandbox/payments/saved-card/offline-payment.md): This method enables businesses to automatically withdraw funds from a customer's saved card without their participation. This feature is useful when a customer has previously save… ### Pre-authorization - [Introduction](https://api.bog.ge/docs/en/sandbox/payments/preauthorization/introduction.md): These methods allow businesses to complete the withdrawal process for the amount that was previously blocked during the order request These methods are useful if the value of the… - [Confirm Pre-Authorization](https://api.bog.ge/docs/en/sandbox/payments/preauthorization/approve.md): This method allows businesses to confirm pre-authorized amounts, either in full or partially. - [Reject Pre-Authorization](https://api.bog.ge/docs/en/sandbox/payments/preauthorization/reject.md): This method allows businesses to reject pre-authorized amounts in full. ### External Orders - [Online Installment Plan Modal](https://api.bog.ge/docs/en/sandbox/payments/external-orders/modal.md): Integration of the installment plan model is necessary only in the case, if you want a consumer to choose the installment plan conditions on your page. - [Google Pay™ on Business' Webpage](https://api.bog.ge/docs/en/sandbox/payments/external-orders/external-googlepay.md): To add Google Pay™ button on your webpage, following steps are required. - [Apple Pay™ on Business' Webpage](https://api.bog.ge/docs/en/sandbox/payments/external-orders/external-applepay.md): To add Apple Pay™ button on your webpage, following steps are required. - [Apple Pay™ Accept Payment](https://api.bog.ge/docs/en/sandbox/payments/external-orders/complete-external-applepay.md): Calling this service is required to complete Apple Pay™ payment initiated on business' webpage. - [Refund](https://api.bog.ge/docs/en/sandbox/payments/refund.md): This method allows merchants to refund the order amount either fully or partially. Full and partial refunds are supported for payments made via card, Apple Pay, Google Pay, BOG au… - [Response Codes](https://api.bog.ge/docs/en/sandbox/payments/response-codes.md) - [Google Pay™](https://api.bog.ge/docs/en/sandbox/payments/googlepay.md): Google Pay™ is the fast, simple way that allows you to make card payments without entering card details for each payment. The card data is safely stored by Google. - [Test Cards](https://api.bog.ge/docs/en/sandbox/payments/test-cards.md) - [Terms Used](https://api.bog.ge/docs/en/sandbox/payments/terms-used.md): 1. Business - a retailer or service company, having an online/electronic system. 2. Online Payments Page - an online payments system, that allows you to easily build a payments' m… ## Sandbox: billing The test environment for the billing gateway: operations, errors and expected response times. ### Authentication Methods - [HTTP Basic](https://api.bog.ge/docs/en/sandbox/paymentgateway/auth-methods/basic.md): If the service-provider chooses to use the HTTP Basic Auth authentication method, then the former must accept the Authorization header whose value follows the Basic authentication… - [OAuth 2.0 - Client Credentials](https://api.bog.ge/docs/en/sandbox/paymentgateway/auth-methods/oauth2.md): The service-provider may create an authorization web-service, which supports the OAuth 2.0 (D. Hardt, Ed., 2012) Client Credentials grant type. BOG will use an HTTP POST request m… - [API Key](https://api.bog.ge/docs/en/sandbox/paymentgateway/auth-methods/apikey.md): The service-provider may provide BOG with an API Key that will be used within each operation. If the key is given, then each operation will contain a header with the format: - [HMAC-SHA256](https://api.bog.ge/docs/en/sandbox/paymentgateway/auth-methods/hmac-sha256.md): The service-provider can additionally provide BOG with a secret key for hashing, which will be used for hashing the request body for HTTP POST & PATCH requests, or in the case of… - [Introduction](https://api.bog.ge/docs/en/sandbox/paymentgateway/introduction.md): The document is intended for service-providers. - [Authentication](https://api.bog.ge/docs/en/sandbox/paymentgateway/authentication.md): This section defines different types of authentication methods supported by the BOG protocol. It is mandatory that a service-provider uses one of the authentication methods listed… ### Pre-defined Operations - [Payment](https://api.bog.ge/docs/en/sandbox/paymentgateway/pre-defined-ops/payment.md): Any number of operations can be defined by the service provider, howbeit, the payment operation with the key payment will always be executed at the end of the operation chain if t… - [Payment Status](https://api.bog.ge/docs/en/sandbox/paymentgateway/pre-defined-ops/payment-status.md): When the payment-status operation is invoked by BOG, the service-provider is expected to respond with one of the following status codes: 12, 13, 14. - [Cancel Payment](https://api.bog.ge/docs/en/sandbox/paymentgateway/pre-defined-ops/cancel-payment.md): When invoking the cancel-payment operation, the service-provider is expected to cancel the payment with the given transaction identifier from BOG. - [Send Payment Info](https://api.bog.ge/docs/en/sandbox/paymentgateway/pre-defined-ops/send-payment-info.md): 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… - [Custom Operations](https://api.bog.ge/docs/en/sandbox/paymentgateway/operations.md): Custom operations are optional. I.e. the service-provider may not define any custom operations at all. - [Expected Response Times](https://api.bog.ge/docs/en/sandbox/paymentgateway/expected-response-times.md): The expected response times, or the response time limits for each operation, are defined below. - OAuth Client Credentials – 15 seconds. - Custom Operations – 10 seconds. - Paymen… - [Definitions, Acronyms & Abbreviations](https://api.bog.ge/docs/en/sandbox/paymentgateway/terms-used.md) - [Exception Cases](https://api.bog.ge/docs/en/sandbox/paymentgateway/error-flow.md): This section contains information regarding the different routes the BOG payment system could take depending on the given circumstances within the payment operation. Keep in mind,… - [Error Codes](https://api.bog.ge/docs/en/sandbox/paymentgateway/error-codes.md): A Service-provider may also introduce other error codes not listed in this table. Such codes must not be within 0-99 range. ## Open banking (OpenAPI) - [Open Banking V1](https://api.bog.ge/docs/en/openapi/openbanking.yaml) - [Open Finance: Account Information Service (AIS)](https://api.bog.ge/docs/en/openapi/BG_oFA_AIS_recent.openapi.yaml) - [Open Finance: Payment Information Service (PIS)](https://api.bog.ge/docs/en/openapi/BG_oFA_PIS_recent.openapi.yaml) - [Open Finance: Extended Account Information Service (XAIS)](https://api.bog.ge/docs/en/openapi/BG_oFA_XAIS_recent.openapi.yaml) - [Open Finance: Extended Payment Information Service (XPIS)](https://api.bog.ge/docs/en/openapi/BG_oFA_XPIS_recent.openapi.yaml)
Code Document Type Description Result Type