Skip to main content

Callback

Unlike the previous methods which are called by the Online Shop, Callback is called by an Online Payment System, while the information should be received and processed on an Online Shop side. This method gives a possibility to receive real-time information about the status change. A Callback URL is assigned to each Online Shop when the latter is registered as a Merchant in a Bank system (see the introduction). Two kinds of Callback URLs can be assigned in a Payment System to a Merchant:

After that each time when the Payment Status is changed, the Payment Details are sent via POST method on a Callback URL To confirm the successful receiving of a Callback method request, a Merchant should return an HTTP CODE 200. In case of the unsuccessful result of sending via POST method of the Callback, the method is called again with 15-second intervals until the number of attempts reaches 5 or Merchant returns an HTTP CODE 200 status. In case the Callback could not be successfully called, the payment status is still successful. It is advised to use a Payment Details method to verify the payment details.

note

A Callback is not related to the redirection to the Online Shop Webpage from the Merchant’s payment system. A redirection happens according to a value passed by Merchant in a redirect_url parameter of an Order request method.

Payment Status Change callback​

  Content-Type: application/x-www-form-urlencoded
  Request Method: POST
  status: success | error 
  order_id: string
  payment_hash: string
  ipay_payment_id: string
  status_description: string
  shop_order_id: string
  payment_method: GC_CARD | BOG_CARD | BOG_LOYALTY | BOG_LOAN | UNKNOWN
  card_type: MC | VISA | AMEX | UNKNOWN

Payment Amount Return callback​

  order_id: string
  payment_hash: string
  ipay_payment_id: string
  status_description: string
  shop_order_id: string
  payment_method: GC_CARD | BOG_CARD | BOG_LOYALTY
  card_type: MC | VISA | AMEX