Prime Trust provides Know Your Customer (KYC) validation for Contacts associated with individual Accounts. This guide provides information on using webhooks and the API to:
- receive notifications for status change on:
- Customer Identification Procedures (CIP),
- Anti-Money Laundering (AML),
- Document Check
- retrieve status for CIP, AML, and Document Check using the API
- retrieve information for next steps required to complete validation on submitted KYC requests
Webhook - a webhook is a mechanism that sends event notifications (in this case from Prime Trust) in the form of a payload to a given resource provided by a subscriber (the integrator).
Status checks and webhooks
KYC webhooks will notify you on updates to CIP, AML, and Document Check status. After a change in status, the webhook sends a payload with a status update notification. The
changesarray will list one value, “status”, to indicate a status change.
Example CIP status payload:
Example Document Check status payload:
After receiving a status change webhook payload, you can then call the following endpoints to retrieve status information.
After encountering a KYC validation issue or the acceptance of KYC validation upon the creation or updating of a Contact, the webhook sends a payload with a code that indicates the required actions for an incomplete KYC validation.
Example payload with KYC required actions:
In the payload, the
kyc-required-actions array contains a list of codes with required actions information.
Example success payload:
In this example, the
changes array returns the following values indicating success:
Error code / required actions reference
|N01||Please verify the individual’s name for accuracy, confirming it reflects the legal name as it reads on the identity document. If the identity document does not reflect the legal name change, provide a legal document that authorizes a name change such as Marriage Certificate, divorce decree, or name change affidavit.|
|N02||Please verify the legal entity name for accuracy, confirming it matches the information with the Secretary of State and contains the company type i.e., LLC, Inc., LLP, etc.|
|N03||Please review the Date of Birth for accuracy, confirming the date is entered in the standard format: MM/DD/YYYY and matches the date on the individual's identity document.|
|N04||Please review the SSN/TIN for accuracy, confirming it is a valid number associated with the individual. If applicable, update the SSN/TIN and provide a copy of the social security card or SS4 Form.|
|N05||Please review the EIN, GIIN, or Company Number for accuracy, confirming it is a valid number associated with the entity. If applicable, provide an SS-4, W-8BEN-E etc.|
|N06||Please review the address for accuracy, confirming the street, city, state, and/or ZIP code are associated with the individual's residential address. PO Box and mail receiving agencies are not accepted; Army Post Office boxes (APO) or Fleet Post Office (FPO) are the exception. If applicable, please provide proof of address (mail item) dated within the last 90 days (e.g., Monthly Bill Statement, Bank/Credit Card Account Statement, Rental Lease Agreement, Vehicle Registration, Copy of Real Estate Property Title or Property Tax Bill).|
|N07||Please review the company address for accuracy, confirming it is the physical, principal place of business either reflected within the company formation documents or Secretary of State. Mailbox addresses, PO Boxes, and registered agent addresses are not allowed. If applicable, provide proof of address (mail item) dated within the last 90 days (e.g., Monthly Bill Statement, Bank/Credit Card Account Statement, Rental Lease Agreement, Vehicle Registration, Copy of Real Estate Property Title or Property Tax Bill).|
|N08||Please provide the Company’s official formation or organizational documentation evidencing the entity's existence (e.g., Certificate of Good Standing).|
|N09||Please provide proof of Beneficial Ownership. Evidence of Beneficial Ownership may be reflected in a company's Operating Agreement, Bylaws, Articles of Incorporation, or Share Registry clearly reflecting ownership percentage or share capital.|
|N10||Please provide a valid Government issued ID, Driver's License or Passport for validation, there may have been an error with the document provided please make sure that it is not expired, the image of the ID is clear, there is no glare or flash, and all four corners are visible.|