Skip to content
/
Notification

Notification
Webhook

Request

This is an outbound HTTP POST message from the Shift4 gateway to the merchant's environment that provides status of the ach request. This notification request will be sent from Shift4 to the URL provided in the merchant's boarding configuration.

This requires the interface vendor to establish a listening service to receive these requests.

Bodyapplication/jsonrequired
One of:
eventobject
Example:
{
  "type": "ach.verify.verification_status_update"
}
achobject
Example:
{
  "verificationType": "P"
}
tokenobject
Example:
{
  "value": "9829283019231234",
  "type": "ACH"
}
transactionobject
Example:
{
  "authSource": "A",
  "responseCode": "A"
}
notificationIdstring, (uuid), = 36 characters

Notification ID value generated by Shift4 and returned in the response. Used for matching webhook notifications back to their original request.

Example:"6ca3c55e-1b7c-4cad-8ae2-cac052b5510d"
serverobject
Example:
{
  "name": "TM01CE"
}
Payload
{
  "event": {
    "type": "ach.verify.verification_status_update"
  },
  "ach": {
    "verificationType": "P"
  },
  "token": {
    "value": "9829283019231234",
    "type": "ACH"
  },
  "transaction": {
    "authSource": "A",
    "responseCode": "A"
  },
  "notificationId": "6ca3c55e-1b7c-4cad-8ae2-cac052b5510d",
  "server": {
    "name": "TM01CE"
  }
}

Responses

Return 200 status to indicate that the Notification was received successfully.