ACH RTA Webhooks

Information related to Solid’s Real-Time Authorization RTA for outgoing ACH pulls
ACH RTA Webhooks
 last updated: 
September 14, 2022

ACH RTA (Real Time Authorization) can be set and enabled in the developer section of the dashboard. The ACH RTA webhook event ach.auth.request is sent on any ACH authorization request. When enabled, the receiver must respond within 2 seconds with an approved or declined response. If the call times out or responds with a non-2xx status code, then stand-in processing rules will apply based on the RTA setup.

All RTA webhook requests are signed with a sd-webhook-sha256-signature header. The secret key is available in the dashboard in the Developer > Real Time Authorization section.

Sample Request

  1. {
  2.   "eventType": "ach.auth.request",
  3.   "programId": "prg-99999999-9999-9999-9999-999999999999",
  4.   "env": "live",
  5.   "data": {
  6.     "Account": {
  7.       "balance": "200.00",
  8.       "currency": "USD",
  9.       "id": "acc-99999999-9999-9999-9999-999999999999",
  10.       "label": "Checking",
  11.       "metadata": null,
  12.       "type": "personalChecking"
  13.     },
  14.     "Ach": {
  15.       "addenda": "",
  16.       "createdAt": "2022-09-01T08:00:00Z",
  17.       "description": "DDA TO DDA:WELLS FARGO IFI::JOE SMITH",
  18.       "id": "act-99999999-9999-9999-9999-999999999999",
  19.       "senderName": "WELLS FARGO IFI",
  20.       "senderRoutingNumber": "121042882",
  21.       "traceNumber": "99999999999999"
  22.     },
  23.     "amount": "75.99",
  24.     "createdAt": "2022-09-01T08:00:00Z",
  25.     "id": "aar-99999999-9999-9999-9999-999999999999",
  26.     "personId": "per-99999999-9999-9999-9999-999999999999",
  27.     "programId": "prg-99999999-9999-9999-9999-999999999999",
  28.     "status": "pending"
  29.   }
  30. }

Sample Response

Response status can be approved or declined with a 200 OK status code.

  1. {
  2.      "status": "approved",
  3. }