Webhook & Redirect URL

Webhooks are used so that anytime an event occurs on your account, your application can be notified with instant, real-time notifications by Squad.
Squad webhooks are HTTP calls that are triggered by specific events. It is necessary only for behind-the-scenes transactions.
This can be set up on your Squad Dashboard by specifying a URL we would send POST requests to whenever a successful transaction occurs.
To process notifications, you need to:
Paste your redirect andCallback/Webhook URL in the space provided on your dashboard by following the steps below:
  • Login to your Squad dashboard.
  • Go to Profile > API & Webhook.
  • In the Webhook URL field, enter your Notification URL.
  • In the redirect URL field, enter your redirect URL- and on completion of payment, the customer will be redirected to the URL with the transaction reference passed as a query param.
  • Enter a redirect URL for your customers to be redirected after they complete payment. Note: The Redirect URL is optional.
To configure webhook notifications: go to dashboard > profile > Api & Webhooks.
The Webhook is a post request that is triggered whenever a transaction is successful
Sample POST request to be sent via webhook upon successful transaction
"Event": "charge_successful",
"TransactionRef": "4678388588A0",
"Body": {
"amount": 83000,
"transaction_ref": "4678388588A0",
"gateway_ref": "4678388588A0_1_1",
"transaction_status": "success",
"email": "[email protected]",
"merchant_id": "SBN1EBZEQ8",
"currency": "NGN",
"transaction_type": "Card",
"merchant_amount": 82170,
"created_at": "2022-09-06T15:28:02.477",
"customer_mobile": null,
"meta": {},
"payment_information": {
"payment_type": "card",
"pan": "408408******4081",
"recurring_id": null,
"card_type": "visa",
"token_id": "tJlYMKcwPd"
Please Note that the encrypted body (x-squad-encrypted-body) is usually sent via the header