Register for an Event
POST
https://webhook-staging.fintainium.com/api/webhooks/register
Businesses provide a callback URL, select the events they want to subscribe to, and identify themselves using their
businessId.Supported Events
Funding.Debit.Completed
AP (Accounts Payable) Context
This ensures sufficient funds are available before sending payments via ACH, Virtual Card, Check, or Rapid Pay.
AR (Accounts Receivable) Context
This is the PULL of money from the customer’s account.
Funding.Credit.Completed
AP (Accounts Payable) Context
AR (Accounts Receivable) Context
Once the AR Customer’s payment clears, the business receives the credited amount.
Summary for End Users
| Term | Meaning | AP (Payables) | AR (Receivables) |
|---|---|---|---|
| Funding Debit | Money being pulled (ACH PULL) | Pull from client’s bank account to fund vendor payments | Pull from AR customer’s bank account to pay an invoice |
| Funding Credit | Money being pushed | Push funds to the vendor (ACH, VC, Check, Rapid Pay) | Push funds to the client’s operating account as a deposit |
Key Features
Funding.Credit.Completed, Funding.Debit.Completed).webhookId and the webhook’s current status upon successful registration.Use this API to automate status updates and eliminate manual transaction polling.
Request
Header Params
Body Params application/json
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://webhook-staging.fintainium.com/api/webhooks/register' \
--header 'sessionKey;' \
--header 'Content-Type: application/json' \
--data '{
"businessId": 893746,
"callbackUrl": "https://client.company.com/fintainium/webhook",
"eventNames": ["Funding.Credit.Completed"]
}'Response Response Example
200 - Registration Success - Success
{
"message": "Webhook registered successfully.",
"webhookId": "b81d2e10-7e56-4fcb-b1d1-fint-id",
"status": "Active"
}
Modified at 2025-12-11 21:31:49