Card RTA Webhooks

Information related to Solid’s Real-Time Authorization RTA for cards
Card RTA Webhooks
 last updated: 
August 9, 2022

Card RTA (Real Time Authorization) can be set and enabled in the developer section of the dashboard. The card RTA webhook event cardauthrequest is sent on any card 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 dashboard in Card RTA section.

Sample Request

  1. {
  2.   "eventType": "cardauthrequest",
  3.   "data": {
  4.     "id": "car-273dd264-a468-4ffd-9427-dc397828d45a",
  5.     "amount": "229",
  6.     "merchant": {
  7.       "merchantName": "TARTINE",
  8.       "merchantCity": "SAN JOSE",
  9.       "merchantState": "CA",
  10.       "merchantCountry": "USA",
  11.       "postalCode": "",
  12.       "merchantCategory": "Bakeries",
  13.       "merchantCategoryCode": "5462"
  14.     },
  15.     "status": "pending",
  16.     "account": {
  17.       "id": "acc-3adc007c-0cfd-4101-95bb-2c6334d82770",
  18.       "label": "Vendor Account",
  19.       "type": "businessChecking",
  20.       "balance": "2055",
  21.       "currency": "USD"
  22.     },
  23.     "card": {
  24.       "id": "crd-06a58924-a1eb-4582-9e4e-0f4a49debd1a",
  25.       "label": "Nov9 physical Card1",
  26.       "bin": "debit",
  27.       "type": "virtual",
  28.       "theme": "",
  29.       "limitAmount": "12000",
  30.       "limitInterval": "allTime"
  31.     },
  32.     "createdAt": "2021-11-22T12:48:16334953535Z"
  33.   }
  34. }

Sample Response

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

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