Skip to main content

​
Bring Your Own (BYO) KYC

Programs can seamlessly integrate their bank-approved KYC vendor with Treasury Prime’s platform using the /kyc endpoint to associate KYC results with a person or business application. Applications remain in a pending status until the Program provides a definitive KYC outcome (ok/error/pending). The KYC outcome decisions account opening automation. For multi-person applications, Treasury Prime leverages a conservative approach - the least favorable individual KYC outcome determines the final application result. For example, if any individual yields a KYC result of error, the corresponding account will not be opened.

​
BYO KYC Integration Process - Step by Step Guide

  1. Create Person Application(s): Use the /apply/person_application endpoint to register individual applicants.
    • Note: physical_address is mandatory for all BYO KYC person applications.
  2. Create Business Application (if applicable): For business accounts, use the /apply/business_application endpoint.
    • Note: tin (Tax Identification Number) and incorporation_state fields are required for BYO KYB business applications.
  3. Perform KYC/KYB Verification: Process identity verification through your third-party KYC provider.
  4. Submit KYC/KYB Results: Transmit verification results to Treasury Prime via the /apply/kyc endpoint.
    • In your request, associate the person/business application with the object_id and specify the object_type (person or business).
    • For multi-person applications, such as multiple people tied to a business account, you’ll need to create separate requests for each KYC result per person application.
    • Set the provider_result field to one of these values:
      • ok - Verification passed, account will open automatically
      • error - Verification failed, account will not open
      • pending - Application requires manual review
    • While optional, we strongly recommend including both provider and provider_full fields to build transparency and trust with banking partners. Without these fields, banking partners will only see the final result without supporting context.
  5. Create Account Application: Submit the account application using the /apply/account_application endpoint.
    • Use the BYO KYC-specific account_product_id provided by Treasury Prime for this request.
⌘I