Weavr Buyers Webhooks API
Buyers are identities representing companies. Once on-boarded, Buyers can create and manage their own instruments via your application.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/weavr-buyers-webhooks-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Weavr Buyers Webhooks API
version: v1
license:
name: private
url: https://weavr.io
x-logo:
url: https://weavr-cdn.s3.eu-central-1.amazonaws.com/weavr-payment-run-logo.png
backgroundColor: '#FFFFFF'
altText: Weavr
description: 'Operations tagged Buyers Webhooks across 2 of this provider''s published API definitions: weavr-payment-run-openapi-original.yml, weavr-buyers-webhooks-api-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://sandbox.weavr.io/payment-run
description: Sandbox
security:
- apiKey: []
authToken: []
tags:
- name: Buyers Webhooks
description: Buyers are identities representing companies. Once on-boarded, Buyers can create and manage their own instruments via your application.
x-displayName: Buyers
paths: {}
webhooks:
buyerKYBWatch:
post:
summary: Buyer KYB status update
description: Notification that the KYB status of a buyer identity has been updated.
operationId: webhook_buyer_kyb_watch
security: []
tags:
- Buyers Webhooks
parameters:
- name: call-ref
in: header
description: 'A call reference generated by the caller and unique to the caller
to provide correlation between the caller and system with a maximum length
of 255
'
required: false
style: simple
explode: false
schema:
type: string
- name: published-timestamp
in: header
description: The timestamp, expressed in Epoch timestamp using millisecond precision, when this event was published.
required: true
style: simple
explode: false
schema:
type: integer
format: int64
- name: signature
in: header
description: The signature to verify the authenticity of this request. This is the base64 hash (HmacSHA256) of the `published-timestamp` using your API key.
required: true
style: simple
explode: false
schema:
type: string
- name: signature-v2
in: header
description: The signature to verify the authenticity of this request. This is the base64 hash (HmacSHA256) of the `call-ref` header, the request body, and the `published-timestamp` header, all concatenated without spaces, and signed using your API key.
required: true
style: simple
explode: false
schema:
type: string
requestBody:
content:
application/json:
schema:
type: object
properties:
type:
type: string
enum:
- buyerKYBWatch
payload:
type: object
properties:
buyerId:
type: string
pattern: ^[0-9]+$
description: Id of the buyer.
status:
type: string
enum:
- NOT_STARTED
- INITIATED
- PENDING_REVIEW
- APPROVED
- REJECTED
description: Effective KYB status of the buyer.
details:
type: array
description: Action which my be required to re-process kyb in case of temporary rejections.
items:
type: string
enum:
- BUYER_DETAILS_UNSATISFACTORY
- ADMIN_USER_UNMATCHED_TO_DIRECTOR_OR_REPRESENTATIVE
- UNDEFINED_REQUIRED_INTERVENTION
- DOCUMENTS_UNSATISFACTORY
- SUPPLIED_DATA_AND_DOCUMENTS_MISMATCH
- LANGUAGE_IN_DOCUMENTS_UNSUPPORTED
- SELFIE_UNSATISFACTORY
- SELFIE_AND_DOCUMENTS_MISMATCH
- BENEFICIARY_DETAILS_UNSATISFACTORY
- REPRESENTATIVE_DETAILS_UNSATISFACTORY
- OTHER
- UNSUPPORTED_COUNTRY
- EXPIRED_KYC_DOCUMENTS
rejectionComment:
type: string
description: Reason shown to the user in case of temporary rejection.
ongoingStatus:
type: string
enum:
- NOT_STARTED
- INITIATED
- PENDING_REVIEW
- APPROVED
- REJECTED
description: Ongoing KYB Status of the buyer.
required: true
responses:
'200':
description: Return a 200 status to indicate that the data was received successfully
servers:
- url: https://sandbox.weavr.io/payment-run
description: Sandbox
buyerBeneficiaryStatusWatch:
post:
summary: Buyer Beneficiary status update
description: Notification that the verification status of a buyer beneficiary has been updated.
operationId: webhook_buyer_beneficiary_kyb_watch
security: []
tags:
- Buyers Webhooks
parameters:
- name: call-ref
in: header
description: 'A call reference generated by the caller and unique to the caller
to provide correlation between the caller and system with a maximum length
of 255
'
required: false
style: simple
explode: false
schema:
type: string
- name: published-timestamp
in: header
description: The timestamp, expressed in Epoch timestamp using millisecond precision, when this event was published.
required: true
style: simple
explode: false
schema:
type: integer
format: int64
- name: signature
in: header
description: The signature to verify the authenticity of this request. This is the base64 hash (HmacSHA256) of the `published-timestamp` using your API key.
required: true
style: simple
explode: false
schema:
type: string
- name: signature-v2
in: header
description: The signature to verify the authenticity of this request. This is the base64 hash (HmacSHA256) of the `call-ref` header, the request body, and the `published-timestamp` header, all concatenated without spaces, and signed using your API key.
required: true
style: simple
explode: false
schema:
type: string
requestBody:
content:
application/json:
schema:
type: object
properties:
type:
type: string
enum:
- buyerBeneficiaryStatusWatch
payload:
type: object
properties:
event:
type: array
description: 'The event that triggered this webhook notification. The event
is structured to describe the parameter that has triggered the event followed
by the action that occurred.
'
items:
type: string
enum:
- STATUS_UPDATED
- BENEFICIARY_TYPE_UPDATED
- FIRST_NAME_UPDATED
- MIDDLE_NAME_UPDATED
- LAST_NAME_UPDATED
- EMAIL_UPDATED
eventDetails:
type: array
description: A reason, if any, describing why this event has occurred.
items:
type: string
enum:
- BUYER_DETAILS_UNSATISFACTORY
- ADMIN_USER_UNMATCHED_TO_DIRECTOR_OR_REPRESENTATIVE
- UNDEFINED_REQUIRED_INTERVENTION
- DOCUMENTS_UNSATISFACTORY
- SUPPLIED_DATA_AND_DOCUMENTS_MISMATCH
- LANGUAGE_IN_DOCUMENTS_UNSUPPORTED
- SELFIE_UNSATISFACTORY
- SELFIE_AND_DOCUMENTS_MISMATCH
- BENEFICIARY_DETAILS_UNSATISFACTORY
- REPRESENTATIVE_DETAILS_UNSATISFACTORY
- OTHER
- UNSUPPORTED_COUNTRY
- EXPIRED_KYC_DOCUMENTS
additionalInformation:
type: object
properties:
buyerId:
type: string
pattern: ^[0-9]+$
description: The buyer id whose beneficiary has triggered this event.
buyerName:
type: string
description: The buyer name whose beneficiary has triggered this event.
adminUserEmail:
type: string
description: The buyer's root user email.
kybStatus:
type: string
enum:
- NOT_STARTED
- INITIATED
- PENDING_REVIEW
- APPROVED
- REJECTED
description: The status of the Full Company Verification Checks for the buyer entity.
beneficiary:
type: object
properties:
type:
type: string
enum:
- UNDEFINED_BENEFICIARY_TYPE
- UBO
- DIRECTOR
- UNKNOWN
- SHAREHOLDER
- PARTNER
- OTHER_DIRECTOR
description: Type of the beneficiary.
firstName:
type: string
description: First name of the beneficiary.
middleName:
type: string
description: Middle name of the beneficiary.
lastName:
type: string
description: Last name of the beneficiary.
email:
type: string
description: Email of the beneficiary.
status:
type: string
enum:
- NOT_STARTED
- INITIATED
- PENDING_REVIEW
- APPROVED
- REJECTED
description: Effective KYB Status of the beneficiary.
ongoingKybStatus:
type: string
enum:
- NOT_STARTED
- INITIATED
- PENDING_REVIEW
- APPROVED
- REJECTED
description: Ongoing KYB Status of the beneficiary.
description: Additional information related to the event triggering this notification.
rejectionComment:
type: string
description: Reason shown to the user in case of temporary rejection.
required: true
responses:
'200':
description: Return a 200 status to indicate that the data was received successfully
servers:
- url: https://sandbox.weavr.io/payment-run
description: Sandbox
buyerWatch:
post:
summary: Buyer update
description: Notification that a buyer has been updated.
operationId: webhook_buyer_watch
security: []
tags:
- Buyers Webhooks
parameters:
- name: call-ref
in: header
description: 'A call reference generated by the caller and unique to the caller
to provide correlation between the caller and system with a maximum length
of 255
'
required: false
style: simple
explode: false
schema:
type: string
- name: published-timestamp
in: header
description: The timestamp, expressed in Epoch timestamp using millisecond precision, when this event was published.
required: true
style: simple
explode: false
schema:
type: integer
format: int64
- name: signature
in: header
description: The signature to verify the authenticity of this request. This is the base64 hash (HmacSHA256) of the `published-timestamp` using your API key.
required: true
style: simple
explode: false
schema:
type: string
- name: signature-v2
in: header
description: The signature to verify the authenticity of this request. This is the base64 hash (HmacSHA256) of the `call-ref` header, the request body, and the `published-timestamp` header, all concatenated without spaces, and signed using your API key.
required: true
style: simple
explode: false
schema:
type: string
requestBody:
content:
application/json:
schema:
type: object
properties:
type:
type: string
enum:
- buyerActivatedWatch
payload:
required:
- actionDoneBy
- buyerId
- supportedCurrencies
type: object
properties:
actionDoneBy:
type: string
enum:
- UNDEFINED
- ADMIN
- EMBEDDER
buyerId:
type: string
supportedCurrencies:
type: array
items:
type: object
required:
- currency
- status
properties:
currency:
type: string
description: The currency expressed in ISO-4217 code.
maxLength: 3
minLength: 3
enum:
- GBP
- EUR
status:
type: string
description: 'The status of the currency, which can include the following values
* `PENDING_KYB_APPROVAL`: The buyer’s KYB process is pending approval.
* `STEPUP_LOGIN_REQUIRED`: The buyer needs to perform a stepped-up login for higher authentication.
* `PENDING_CREATION`: Awaiting the setup completion of the currency
* `ACTIVE`: The ZBA has been successfully created and is ready for use.
* `UNAVAILABLE`: The currency is unavailable and cannot be used.
'
enum:
- PENDING_KYB_APPROVAL
- STEPUP_LOGIN_REQUIRED
- PENDING_CREATION
- ACTIVE
- UNAVAILABLE
required: true
responses:
'200':
description: Return a 200 status to indicate that the data was received successfully
servers:
- url: https://sandbox.weavr.io/payment-run
description: Sandbox
buyerDeactivatedWatch:
post:
summary: Buyer deactivation
description: Notification that a buyer identity has been deactivated.
operationId: webhook_buyer_deactivated_watch
security: []
tags:
- Buyers Webhooks
parameters:
- name: call-ref
in: header
description: 'A call reference generated by the caller and unique to the caller
to provide correlation between the caller and system with a maximum length
of 255
'
required: false
style: simple
explode: false
schema:
type: string
- name: published-timestamp
in: header
description: The timestamp, expressed in Epoch timestamp using millisecond precision, when this event was published.
required: true
style: simple
explode: false
schema:
type: integer
format: int64
- name: signature
in: header
description: The signature to verify the authenticity of this request. This is the base64 hash (HmacSHA256) of the `published-timestamp` using your API key.
required: true
style: simple
explode: false
schema:
type: string
- name: signature-v2
in: header
description: The signature to verify the authenticity of this request. This is the base64 hash (HmacSHA256) of the `call-ref` header, the request body, and the `published-timestamp` header, all concatenated without spaces, and signed using your API key.
required: true
style: simple
explode: false
schema:
type: string
requestBody:
content:
application/json:
schema:
type: object
properties:
type:
type: string
enum:
- buyerDeactivatedWatch
payload:
required:
- actionDoneBy
- buyerId
- reasonCode
- supportedCurrencies
type: object
properties:
actionDoneBy:
type: string
enum:
- UNDEFINED
- ADMIN
- EMBEDDER
buyerId:
type: string
reasonCode:
type: string
enum:
- UNDEFINED_REASON
- ACCOUNT_REVIEW
- ACCOUNT_SECURITY
- TEMPORARY
- ACCOUNT_CLOSURE
- ACCOUNT_ABANDONED
supportedCurrencies:
type: array
items:
type: object
required:
- currency
- status
properties:
currency:
type: string
description: The currency expressed in ISO-4217 code.
maxLength: 3
minLength: 3
enum:
- GBP
- EUR
status:
type: string
description: 'The status of the currency, which can include the following values
* `PENDING_KYB_APPROVAL`: The buyer’s KYB process is pending approval.
* `STEPUP_LOGIN_REQUIRED`: The buyer needs to perform a stepped-up login for higher authentication.
* `PENDING_CREATION`: Awaiting the setup completion of the currency
* `ACTIVE`: The ZBA has been successfully created and is ready for use.
* `UNAVAILABLE`: The currency is unavailable and cannot be used.
'
enum:
- PENDING_KYB_APPROVAL
- STEPUP_LOGIN_REQUIRED
- PENDING_CREATION
- ACTIVE
- UNAVAILABLE
required: true
responses:
'200':
description: Return a 200 status to indicate that the data was received successfully
servers:
- url: https://sandbox.weavr.io/payment-run
description: Sandbox
components:
securitySchemes:
apiKey:
name: api-key
type: apiKey
in: header
description: The API Key representing your Weavr account. You can find your API Key in your Weavr Portal in the API Credentials page.
authToken:
type: http
description: The authentication token representing the user. This will be included in the login response object.
scheme: bearer
bearerFormat: JWT
x-refined-from:
- weavr-payment-run-openapi-original.yml
- weavr-buyers-webhooks-api-openapi.yml
x-tagGroups:
- name: Access
tags:
- Access Token
- User Impersonation
- Consent Request
- name: Identities
tags:
- Corporates
- Consumers
- name: User Management
tags:
- Authorised Users
- name: Instruments
tags:
- Managed Accounts
- Managed Cards
- name: Transactions
tags:
- Transfers
- name: Fees
tags:
- Fees
- name: Bulk Operations [Beta]
tags:
- Operations
- Manage