# Buyer KYB status update

Notification that the KYB status of a buyer identity has been updated.

Endpoint: POST buyerKYBWatch
Version: v1
Security: 

## Header parameters:

  - `call-ref` (string)
    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

  - `published-timestamp` (integer, required)
    The timestamp, expressed in Epoch timestamp using millisecond precision, when this event was published.

  - `signature` (string, required)
    The signature to verify the authenticity of this request.  This is the base64 hash (HmacSHA256) of the published-timestamp using your API key.

  - `signature-v2` (string, required)
    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.

## Request fields (application/json):

  - `type` (string)
    Enum: "buyerKYBWatch"

  - `payload` (object)

  - `payload.buyerId` (string)
    Id of the buyer.

  - `payload.status` (string)
    Effective KYB status of the buyer.
    Enum: "NOT_STARTED", "INITIATED", "PENDING_REVIEW", "APPROVED", "REJECTED"

  - `payload.details` (array)
    Action which my be required to re-process kyb in case of temporary rejections.
    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"

  - `payload.rejectionComment` (string)
    Reason shown to the user in case of temporary rejection.

  - `payload.ongoingStatus` (string)
    Ongoing KYB Status of the buyer.
    Enum: "NOT_STARTED", "INITIATED", "PENDING_REVIEW", "APPROVED", "REJECTED"


## Response 200 fields