v1

latestOpenAPI 3.0.02026-07-2667172347.6 KB
Webhooks

Bank Account Verification Webhooks

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>.

post/bav/{paymentId}

Path parameters

paymentIdstring required

Our unique identifier for the reference payment. <br /><br />Format: uuid string <br /><br />Example: 790f325a-48c9-4b82-bb53-c0ea128236f0

Headers

Authorizationstring required

The access_token returned in your most recent Create access token response.

Request body

clientIdstring 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

paymentIdstring 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. <br />Validation: Valid enum value <br />Errors: Invalid enum value.

messagestring

Response

Return HTTP 2xx to acknowledge receipt. See Handle webhook deliveries.

object required

A successful response is empty.