Skip to main content

Callbacks

Fondy uses callbacks to notify merchants when a payment is completed. To ensure callback notifications are received successfully, follow the instructions presented on this page.

Allow Fondy's Server IP Addresses​

Update your firewall settings to allow traffic from the following IP addresses:

  • 54.154.216.60

This ensures that callback responses from Fondy can reach your server.

Processing Callback Responses​

A callback is considered successfully processed if your server responds with an HTTP 200 OK status. If a different status code is returned, Fondy will retry sending the callback at the following intervals (in seconds):

  • 2 seconds
  • 60 seconds
  • 300 seconds
  • 600 seconds
  • 3600 seconds
  • 86400 seconds (24 hours)

Ensure your system is configured to handle retries appropriately.

Callback Request Details​

Fondy sends callback requests with the following User-Agent header:

Mozilla/5.0 (X11; Linux x86_64; Twisted) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/63.0.3239.108 Safari/537.36

Callback Example​

When a payment is completed, Fondy sends a POST request to the merchant's specified callback URL with a JSON payload containing the payment details. Below is an example of such a callback:

{
  "rrn": "111111111111",
  "masked_card": "444455XXXXXX1111",
  "sender_cell_phone": "",
  "sender_account": "",
  "currency": "GBP",
  "fee": "",
  "reversal_amount": "0",
  "settlement_amount": "0",
  "actual_amount": "200",
  "response_description": "",
  "sender_email": "test@test.com",
  "order_status": "approved",
  "response_status": "success",
  "order_time": "13.07.2024 01:23:59",
  "actual_currency": "GBP",
  "order_id": "test33694502191",
  "tran_type": "purchase",
  "eci": "5",
  "settlement_date": "",
  "payment_system": "card",
  "approval_code": "123456",
  "merchant_id": 1549901,
  "settlement_currency": "",
  "payment_id": 805243692,
  "card_bin": 444455,
  "response_code": "",
  "card_type": "VISA",
  "amount": "200",
  "signature": "b7884b5c4906956fbac4d20390388d913a78c0b0",
  "product_id": "",
  "merchant_data": "Test merchant data",
  "rectoken": "",
  "rectoken_lifetime": "",
  "verification_status": "",
  "parent_order_id": "",
  "fee_oplata": "0",
  "additional_info": "{\"capture_status\": null, \"capture_amount\": null, \"reservation_data\": \"{}\", \"transaction_id\": 1994930931, \"bank_response_code\": null, \"bank_response_description\": null, \"client_fee\": 0.0, \"settlement_fee\": 0.0, \"bank_name\": null, \"bank_country\": null, \"card_type\": \"VISA\", \"card_product\": \"empty_visa\", \"card_category\": null, \"timeend\": \"13.07.2024 01:24:08\", \"ipaddress_v4\": \"178.54.60.26\", \"payment_method\": \"card\", \"version_3ds\": 1, \"is_test\": true}",
  "response_signature_string": "**********|200|GBP|{\"capture_status\": null, \"capture_amount\": null, \"reservation_data\": \"{}\", \"transaction_id\": 1994930931, \"bank_response_code\": null, \"bank_response_description\": null, \"client_fee\": 0.0, \"settlement_fee\": 0.0, \"bank_name\": null, \"bank_country\": null, \"card_type\": \"VISA\", \"card_product\": \"empty_visa\", \"card_category\": null, \"timeend\": \"13.07.2024 01:24:08\", \"ipaddress_v4\": \"178.54.60.26\", \"payment_method\": \"card\", \"version_3ds\": 1, \"is_**********\": true}|200|123456|444455|VISA|GBP|5|0|444455XXXXXX1111|Test merchant data|1549901|**********33694502191|approved|13.07.2024 01:23:59|805243692|card|success|0|111111111111|**********@**********.com|0|purchase"
}