Register a Webhook

Registering a webhook via API call involves configuring a client application to receive notifications and updates from our ACH API. To enable notification related to transaction, you need to register webhook with sets of predefined Events. Once registered, the webhook will be triggered by the ACH API whenever a relevant event occurs, such as a transaction started, completed or failed. The webhook will then send a notification to the configured endpoint, which can be processed by the client application to perform additional actions or update relevant data.

This route is secured with processor and vendor token authentication.

Endpoint

POST /3p/api/v1/webhook

Request Payload

{
    "webhook_url": [
      "https://example.com/webhook/transaction"
    ],
    "event_names": [
      "TransactionCompleted",
      "TransactionFailed"
    ]
}

Fields	Type	Is Required	Description
webhook_url	string array	Yes	HTTPS url with support to receive post requests
event_names	string array	Yes	Possible Values: TransactionStarted TransactionCaptureStarted TransactionCompleted TransactionFailed TransactionCanceled PayoutFailed PayoutCompleted ClawbackStarted ClawbackFailed ClawbackCompleted BankLinkedSuccessfully BankLinkFailed BankAccountRemoved BusinessCreated BusinessUpdated BatchPayout (only by processor token) RefundPending RefundCaptureStarted RefundCaptureCompleted RefundCaptureFailed RefundPayoutPending RefundPayoutCompleted RefundPayoutFailed BatchRefund (only by processor token) ReversePayoutStarted ReversePayoutCompleted ReversePayoutFailed

Response Object

{
    "status": true,
    "message": "Webhook registered successfully!",
    "data": null,
    "errors": []
}

Errors & Warnings

Code	Message
401
422

Getting Started

Users

Transactions

Payouts

Refunds

Bank Accounts

Webhooks

Billing

Register a Webhook

Endpoint

Request Payload

Response Object

Errors & Warnings

​Endpoint

​Request Payload

​Response Object

​Errors & Warnings

Endpoint

Request Payload

Response Object

Errors & Warnings