Webhooks

Webhooks are an incredibly useful and resource-light method to implement event reactions. Webhooks provide a mechanism whereby a server-side application can notifiy a client application when a new event occurs in which a client may be interested.

Webhooks operate on the concept of 'event reaction' and thus avoid the need for constant polling of the server by the client. Leveraging webhooks, client applications are able to subscribe for push notifications when specific actions occur within Victor.

Webhook Configuration

When configuring a webhook on Victor, the callback response will be sent to the provided URL. The webhook can be created and configured either through the Victor Platform UI or via API.

Webhook Events

After configuration of the webhook URL, the account will be subcribed to receive notifications for the following transactional events that can occur both internal and external to Victor:

Transaction Type Description Status
Outbound ACH ACH transaction originating within Victor and being sent to an account at another financial institution Pending, Sent, Success, OnHold, Failed
Outbound Wire Wire transaction originating within Victor and being sent to an account at another financial institution Pending, Success, OnHold, Failed
Book Internal Transfer Transaction originating within Victor and being sent to an account at the same financial instution, but owned by the same accountholder Pending, Success
Book External Transfer Transaction originating within Victor and being sent to an account at the same financial instution, but owned by a different accountholder Pending, Success
Inbound ACH Transaction ACH Transaction originating outside of Victor and being sent to an account within Victor Pending, Success
Inbound Wire Transaction Wire Transaction originating outside of Victor and being sent to an account within Victor Pending, Success

💡

Info

When creating the webhook, the json parameter can be used to specify that you want the response to be returned as a JSON object. By default, webhooks payloads are URL-encoded.

Sample Webhook Payloads (URL-encoded)

Outbound ACH

amount=1.00&fee_amount=0.00&signature=MIGIAkIBwggQpNZ7KDjpo2R0ALAGr%2BS
%2B%2BgKr0fFguiDUmj9wDbkcJaGVyrFiBgp3l5Ll7TB7%2BKYKMvtNiuZaGOjLPK1s0d4CQgC7UhrbpIBzaTsp%2FYxNTzl71Md2tR1UKasa7Xfc9f0k2EFN0SFq22HbzAuSpHex1lsBvHVNdOAaZEJN%2F2CVNmPZXA%3D%3D&
created_at=1631556548813&id=WSBJRZE3SV&transaction_type=ach_transfer&status=Pending

Outbound Wire

amount=1.00&fee_amount=0.00&
signature=MIGGAkFEKAgqU7yk5tGFdZ1RRnHU9rJHGa4pZHwhRKZ1nqyp0vV%2FQx8gqAEeObh0Dgu7CFnrlTVZ%2FNQntk6ess2ojZnumAJBBzrjyMsI1DwPTmu2MOTtAcc2P80X3%2Bhy9J5w8zxIdwrI8mm7KLrmMEq%2Fz6g1iRR8XovW0ZEKYSnONYfZWDdfJxo%3D&
created_at=1631556542249&id=A01XSA6XMY&
transaction_type=wire_transfer&status=Pending

Book Internal

to_account_number=66600000200&to_account_name=TestAccountFour&amount=1.00&
signature=MIGGAkECPyn0qVoc08X2M7NP4q6sd962VzmHJ39dg4LDDhr63PFzYseBz1aAez6S53mEohquf4zC0rLCkCxGhzdo%2BpPaHgJBSgY6VzfKsRyZA9B5mM7Z01yr7D2qIHCdMDxeopEP9ZMO47nFUErU7rohkjfGOlS4eQwXpcBAjZ0fVpVA%2BUF5bDY%3D&
created_at=1631556555133&description=Test+Automation+Book+Internal&transaction_type=book_internal&
from_account_name=TestAccountOne&completed_at=1631556555215&
fee_amount=0.00&from_account_number=66600000197&id=H5XWX7U6IA&status=Success

Book External

to_account_number=66600000191&to_account_name=new+uat&amount=1.00&
signature=MIGHAkIBl1pPd%2FYHAm69oX8aAY0KLnxn%2FC1I7ulwZNxC6TRCKRyvhVR7oimqJ8IQVAVk2FZp8tp1E7wMfldgUehpn8UzBpICQQUCjO0J47vJ0lzbNQudZG%2BERyFlZR91qV1MihINPNAcMSSGsb92NoMPw3BoRUf5fdVyJ3mgFLnFiFfMFFTjv5D%2B&
created_at=1631556552182&description=Test+Automation+Book+External&transaction_type=book_external&
from_account_name=TestAccountOne&completed_at=1631556552263&fee_amount=0.00&
from_account_number=66600000197&id=9HBAMQ3F0H&status=Success

Inbound ACH

aCHCompName=JH+BANK+%26+TRUST&
signature=MIGHAkIBvfSe6hGqPGoOqK%2BDNHMtWkGOKJ23YJZeukxEidHjOvFksNWRIGzYlQOHXkXNHjaebGKXcpHHuI0q50kNP33ny2QCQS7IJtdxJH%2BZ%2BTz0T7g0Q06a2m9J7jPQRrHeJLKgYWAFqWBkd5JAPyfU8oyMi%2FyRxW5EzG0t%2B0sjjucBUJvRO7br&
acctType=D&acctId=1903327&amt=64.12&effDt=71007&aCHTrnType=Dr

Inbound Wire

chanType=test&
signature=MIGHAkEhrE8b9g%2FQ%2FHpJwRNXDd5xcHi%2FqXfPLJvXmsD8ZIkxzULR2plkMotGq1liyMLKFE55IzawpTSCw%2FXoE%2F5Gie9k3AJCAXwQkvVfCxH0hUjJVKFJxxjKDRfltj12GgQ6Ao18xWPJJbs%2Bi0lutmTS%2BJd%2FeU6f4JzygBo2FfssC%2BKJXGgo0mT0
&acctType=D&amt=.01&acctId=1903327
&trnClsfType=test&trnRcptId=JWG813INRP&trnType=Dr&validConsmProd=test&
trnCat=MemoPost&trnCodeDesc=Electronic+Debit+Savings

Sample Webhook Payloads (JSON)

Coming Soon!