1. Webhooks
Fintainium APIs
  • Overview
  • Quick Start
  • Use Cases
  • Recipies
    • Connect with Vendor
    • Pay a Vendor
  • API Reference
    • AP Payouts (Accounts Payable)
      • Vendor (Recipient)
        • Create new vendor
        • Update Vendor
        • View Vendor Details
      • Payments (Payouts)
        • Initiate Payment
        • Add Payment Method
      • Bills
        • Create new Bill
      • Country State City
        • GET City List by State Name/ID/Code
    • AR Collection (Accounts Receivable)
      • Invoices
        • Create new Invoice
      • Customers
        • Create new customer
      • Payment (Collection)
        • Initiate Payment
        • Add Payment Method
    • Simplified Payouts
      • Send Payouts
    • Transactions
      • Retrieve Transaction Status
    • Webhooks
      • Register for an Event
        POST
      • Get Webhook Registration Status
        POST
    • Sub-Ledger
      • Retrieve Balance
  1. Webhooks

Get Webhook Registration Status

POST
https://webhook-staging.fintainium.com/api/webhooks/status/[business_Id]
The Get Webhook Registration Status API allows API-using businesses to retrieve their current webhook registration details, including the callback URL, subscribed event names, the webhook’s status, and the timestamp of the most recent successfully delivered webhook.
This endpoint helps businesses confirm whether their webhook is active and correctly configured to receive real-time event updates such as
Funding.Credit.Completed and Funding.Debit.Completed.
Currently supported events include Funding.Credit.Completed and Funding.Debit.Completed. Additional webhook events will be introduced in future releases.

Key Features#

Retrieve the current webhook configuration for a business.
View registered event names and the configured callback URL.
Check the status of the webhook (Active, Inactive, or Failed).
Review the timestamp of the last successfully delivered webhook for monitoring delivery health.
Helps validate proper webhook setup and troubleshooting.

Request Specification#

Method: GET
Name: Webhook Registration Status
URL: /api/webhooks/status

Example Request#

Request

Header Params

Responses

🟢200Success
application/json
Bodyapplication/json

Request Request Example
Shell
JavaScript
Java
Swift
curl --location --globoff --request POST 'https://webhook-staging.fintainium.com/api/webhooks/status/[business_Id]' \
--header 'sessionKey;'
Response Response Example
{

  "webhook_id": "b81d2e10-7e56-4fcb-b1d1-fint-id",

  "callback_url": "https://client.company.com/fintainium/webhook",

  "event_names": ["payment_status_update"],

  "status": "Active",

  "last_sent": "2025-07-15T10:20:00Z"

}
Modified at 2025-12-11 21:32:47
Previous
Register for an Event
Next
Retrieve Balance
Built with