Server To Server Notification V1
Throughout its entire roadmap, Your FawryPay transactions shall experience several status updates. Depending on the specific nature of your core business, the status of your clients’ transactions can range from created, paid, cancelled, expired, shipped to delivered. Whenever the status of one of your transactions has been altered, FawryPay will send an informative HTTP GET request to your preconfigured endpoint on your own application server with the current detailed status of your transaction. Note that your endpoint need to be set during your registration process as a merchant with FawryPay (Register as a merchant). You can optionally implement a service to handle this request so that you can avail the service to the customer or update your stock automatically. You will need to provide your endpoints (callback notification URL) for both development and production environments.
FawryPay Example HTTP GET request to the merchant callback URL
Assuming you have providedhttp://MerchantURL/merchatCallbakPage as your callback URL, FawryPay server to serve API V1 will send the follwoing HTTP GET request whenever the status of your transaction has been altered:
HTTP GET Request Parameters
Detailed description of the parameters associated with FawryPay server to server notification API V1 are given in the table below.
||The reference number of the order on merchant's system which passed through loadFawryPluginPopup()||123456|
||The reference number of the order on FawryPay system which is displayed to the customer and used during the payment.||9990076204|
||The updated status of your transaction.||NEW, PAID, CANCELED, DELIVERED, REFUNDED, EXPIRED|
||The amount value received from merchant to be paid by the customer, the merchant can use it to verify that the customer has paid the required amount to enable the service to the customer.||350.50|
||The MD5 digested for the following concatenated string (secureKey + amount (in two decimal format 10.00) + fawryRefNo + merchantRefNum + orderStatus)||5AD9731AE0FF009D586E6FB1F5CE26F8|
Expected Body Response
FawryPay check on the http response status so return empty response and in case of http response status 200 the call back will be marked as delivered else FawryPay will keep sending the HTTP request for a preconfigured number of retries.
Was this page helpful?