---
title: "Bank Account Verification Webhooks"
method: POST
path: "/bav/{paymentId}"
tags: ["Webhooks"]
---

# Bank Account Verification Webhooks

`POST /bav/{paymentId}`

Webhook notifications for <a href="https://docs.fourthline.com/docs/bav-overview">Bank Account Verification</a>. For setup and authentication, see <a href="https://docs.fourthline.com/docs/webhooks">Webhooks</a>.

## Path parameters

- `paymentId` string, required

## Headers

- `Authorization` string, required — The `access_token` returned in your most recent [Create access token](https://docs.fourthline.com/reference/create-access-token) response.

## Request body

- object
  - `clientId` string, required — Our unique identifier for the client. <br /><br />Format: uuid string <br /><br />Example: `790f325a-48c9-4b82-bb53-c0ea128236f0` <br />Validations: uuid format, `clientId` exists
  - `paymentId` string, required — Our unique identifier for the reference payment. <br /><br />Format: uuid string <br /><br />Example: `790f325a-48c9-4b82-bb53-c0ea128236f0` <br />Validations: uuid format, `paymentId` exists <br />Errors: Format is incorrect or doesn’t exist
  - `status` 'failed' | 'pending', required — The [payment status](https://docs.fourthline.com/docs/bav-statuses). <br />Validation: Valid enum value <br />Errors: Invalid enum value.
  - `message` string — The [status code](https://docs.fourthline.com/docs/bav-statuses#status-codes).

## Response `200`

Return HTTP 2xx to acknowledge receipt. See [Handle webhook deliveries](https://docs.fourthline.com/docs/webhooks#200-ok).

- object — A successful response is empty.

## Other responses

- `401` — Fourthline could not authenticate with your webhook endpoint. See [troubleshooting](https://docs.fourthline.com/docs/webhooks#401-unauthorized).
- `403` — Fourthline could not authenticate with your webhook endpoint. See [troubleshooting](https://docs.fourthline.com/docs/webhooks#403-forbidden).
- `404` — Fourthline can reach your server, but the webhook endpoint could not be found. See [troubleshooting](https://docs.fourthline.com/docs/webhooks#404-not-found).
- `500` — Your server received the request but could not process it successfully. See [troubleshooting](https://docs.fourthline.com/docs/webhooks#500-internal-server-error).

---

[API](https://skmtc.net/fourthline/apis/fourthline-apis.md) · [All operations](https://skmtc.net/fourthline/apis/fourthline-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fourthline/fourthline-apis/revisions/7991ae7c8383/schema)