vesant-sdk 1.7.0-dev.c2e85f3 → 1.7.0-dev.e3140ee

package/dist/kyc/index.d.mts

@@ -327,6 +327,40 @@ interface RequestKycSubmitLinkRequest {
      * Omitted or unknown values default to KYC required with no skip.
      */
     trigger_event?: string;
+    /**
+     * Registered customer identity data (optional). Seeds the customer's risk
+     * profile so document verification can cross-check the submitted document
+     * against trusted reference data (name/DOB match, address verification).
+     * Fields never overwrite data already on the profile.
+     */
+    customer_data?: KycCustomerData;
+}
+/**
+ * Customer identity data supplied by your platform on a submit-link request.
+ * Mirrors the geolocation `customer_data` contract. Every field is optional
+ * and never overwrites data already on the customer's risk profile.
+ */
+interface KycCustomerData {
+    /**
+     * Customer's registered full name. Used to match the OCR-extracted name
+     * on the submitted document.
+     */
+    full_name?: string;
+    /**
+     * Customer's registered date of birth. ISO 8601 date ("1999-06-02") or an
+     * RFC 3339 timestamp ("1986-09-06T18:30:00.000+00:00", as produced by
+     * `Date.prototype.toISOString()`) — for timestamps the date portion is
+     * used. Used for DOB matching against the submitted document.
+     */
+    date_of_birth?: string;
+    /** Customer's email address */
+    email?: string;
+    /** Customer's phone number */
+    phone?: string;
+    /** Customer's residential address. Used for address verification. */
+    address?: string;
+    /** Customer's country of residence */
+    country?: string;
 }
 /**
  * Trigger events that can request Event-Based Face Verification.
@@ -686,7 +720,7 @@ interface UseKycPreferencesResult extends BaseHookState {
  */
 declare class KycClient extends BaseClient {
     private userId?;
-    private riskProfileBaseURL?;
+    private readonly riskProfileBaseURL?;
     constructor(config: KycClientConfig);
     /**
      * Set the user ID for operations requiring user context
@@ -705,7 +739,13 @@ declare class KycClient extends BaseClient {
      *
      * Generates a link that the user can visit to submit their KYC documents.
      *
-     * @param request - Request containing the user ID, optional redirect URL, and optional callback URL (receives POST requests)
+     * Optionally pass the customer's registered identity data as
+     * `customer_data` (same shape as the geolocation `customer_data` block).
+     * It seeds the customer's risk profile so document verification can
+     * cross-check the submitted document against trusted reference data;
+     * fields never overwrite data already on the profile.
+     *
+     * @param request - Request containing the user ID, optional redirect URL, optional callback URL (receives POST requests), and optional customer identity data
      * @returns Response containing the redirect link and KYC ID
      *
      * @example
@@ -713,7 +753,15 @@ declare class KycClient extends BaseClient {
      * const result = await client.requestKycSubmitLink({
      *   user_id: "user_123",
      *   redirect_url: "https://merchant.com/kyc-complete", // optional
-     *   callback_url: "https://merchant.com/api/kyc-webhook" // optional - receives POST requests on status change
+     *   callback_url: "https://merchant.com/api/kyc-webhook", // optional - receives POST requests on status change
+     *   customer_data: { // optional - seeds the risk profile for document cross-checks
+     *     full_name: "John Doe",
+     *     date_of_birth: "1999-06-02", // ISO 8601
+     *     email: "john@example.com",
+     *     phone: "+94771234567",
+     *     address: "12 Main St, Colombo", // used for address verification
+     *     country: "LK"
+     *   }
      * });
      *
      * console.log(`Redirect user to: ${result.link}`);
@@ -1098,4 +1146,4 @@ declare class KycClient extends BaseClient {
     createCustomerProfile(profile: CreateProfileRequest): Promise<CustomerProfile>;
 }
 
-export { type CheckKycStatusRequest, type CheckKycStatusResponse, CreateProfileRequest as CreateCustomerProfileRequest, type CreateEventBasedFaceVerificationSessionRequest, type CreateEventBasedFaceVerificationSessionResponse, CustomerProfile, ProfileFilters as CustomerProfileFilters, ProfileListResponse as CustomerProfileListResponse, type DocumentType, type DocumentVerificationRequest, type DocumentVerificationResponse, type EventBasedFaceVerificationCallback, type EventBasedFaceVerificationDeviceType, type EventBasedFaceVerificationEvent, type EventBasedFaceVerificationFrequencyTrigger, type EventBasedFaceVerificationReactionResult, type EventBasedFaceVerificationReactions, type EventBasedFaceVerificationThresholdTrigger, type EventBasedFaceVerificationTriggers, type FaceProof, KYC_DECLINED_DESCRIPTIONS, type KycAlert, type KycAlertFilters, type KycAlertListResponse, type KycAlertStatus, type KycAlertType, KycClient, type KycClientConfig, type KycCustomerProfile, type KycDeclinedCode, type KycHandoffSession, type KycOverview, type KycPagination, type KycPreferences, type KycRequest, type KycRequestFilters, type KycRequestListResponse, type KycStatus, type Name, PaginationParams, type Proof, type ProofDownloadURL, type ProofType, type RequestAdditionalDocumentsRequest, type RequestKycSubmitLinkRequest, type RequestKycSubmitLinkResponse, RiskLevel, type SubmitEventBasedFaceVerificationSessionRequest, type SubmittedDocument, type SupportedDocumentType, type UpdateKycAlertRequest, type UpdateKycPreferencesRequest, type UpdateKycStatusRequest, type UseKycAlertsOptions, type UseKycAlertsResult, type UseKycOverviewOptions, type UseKycOverviewResult, type UseKycPreferencesResult, type UseKycRequestsOptions, type UseKycRequestsResult, type UseKycSubmissionOptions, type UseKycSubmissionResult };
+export { type CheckKycStatusRequest, type CheckKycStatusResponse, CreateProfileRequest as CreateCustomerProfileRequest, type CreateEventBasedFaceVerificationSessionRequest, type CreateEventBasedFaceVerificationSessionResponse, CustomerProfile, ProfileFilters as CustomerProfileFilters, ProfileListResponse as CustomerProfileListResponse, type DocumentType, type DocumentVerificationRequest, type DocumentVerificationResponse, type EventBasedFaceVerificationCallback, type EventBasedFaceVerificationDeviceType, type EventBasedFaceVerificationEvent, type EventBasedFaceVerificationFrequencyTrigger, type EventBasedFaceVerificationReactionResult, type EventBasedFaceVerificationReactions, type EventBasedFaceVerificationThresholdTrigger, type EventBasedFaceVerificationTriggers, type FaceProof, KYC_DECLINED_DESCRIPTIONS, type KycAlert, type KycAlertFilters, type KycAlertListResponse, type KycAlertStatus, type KycAlertType, KycClient, type KycClientConfig, type KycCustomerData, type KycCustomerProfile, type KycDeclinedCode, type KycHandoffSession, type KycOverview, type KycPagination, type KycPreferences, type KycRequest, type KycRequestFilters, type KycRequestListResponse, type KycStatus, type Name, PaginationParams, type Proof, type ProofDownloadURL, type ProofType, type RequestAdditionalDocumentsRequest, type RequestKycSubmitLinkRequest, type RequestKycSubmitLinkResponse, RiskLevel, type SubmitEventBasedFaceVerificationSessionRequest, type SubmittedDocument, type SupportedDocumentType, type UpdateKycAlertRequest, type UpdateKycPreferencesRequest, type UpdateKycStatusRequest, type UseKycAlertsOptions, type UseKycAlertsResult, type UseKycOverviewOptions, type UseKycOverviewResult, type UseKycPreferencesResult, type UseKycRequestsOptions, type UseKycRequestsResult, type UseKycSubmissionOptions, type UseKycSubmissionResult };

package/dist/kyc/index.d.ts

@@ -327,6 +327,40 @@ interface RequestKycSubmitLinkRequest {
      * Omitted or unknown values default to KYC required with no skip.
      */
     trigger_event?: string;
+    /**
+     * Registered customer identity data (optional). Seeds the customer's risk
+     * profile so document verification can cross-check the submitted document
+     * against trusted reference data (name/DOB match, address verification).
+     * Fields never overwrite data already on the profile.
+     */
+    customer_data?: KycCustomerData;
+}
+/**
+ * Customer identity data supplied by your platform on a submit-link request.
+ * Mirrors the geolocation `customer_data` contract. Every field is optional
+ * and never overwrites data already on the customer's risk profile.
+ */
+interface KycCustomerData {
+    /**
+     * Customer's registered full name. Used to match the OCR-extracted name
+     * on the submitted document.
+     */
+    full_name?: string;
+    /**
+     * Customer's registered date of birth. ISO 8601 date ("1999-06-02") or an
+     * RFC 3339 timestamp ("1986-09-06T18:30:00.000+00:00", as produced by
+     * `Date.prototype.toISOString()`) — for timestamps the date portion is
+     * used. Used for DOB matching against the submitted document.
+     */
+    date_of_birth?: string;
+    /** Customer's email address */
+    email?: string;
+    /** Customer's phone number */
+    phone?: string;
+    /** Customer's residential address. Used for address verification. */
+    address?: string;
+    /** Customer's country of residence */
+    country?: string;
 }
 /**
  * Trigger events that can request Event-Based Face Verification.
@@ -686,7 +720,7 @@ interface UseKycPreferencesResult extends BaseHookState {
  */
 declare class KycClient extends BaseClient {
     private userId?;
-    private riskProfileBaseURL?;
+    private readonly riskProfileBaseURL?;
     constructor(config: KycClientConfig);
     /**
      * Set the user ID for operations requiring user context
@@ -705,7 +739,13 @@ declare class KycClient extends BaseClient {
      *
      * Generates a link that the user can visit to submit their KYC documents.
      *
-     * @param request - Request containing the user ID, optional redirect URL, and optional callback URL (receives POST requests)
+     * Optionally pass the customer's registered identity data as
+     * `customer_data` (same shape as the geolocation `customer_data` block).
+     * It seeds the customer's risk profile so document verification can
+     * cross-check the submitted document against trusted reference data;
+     * fields never overwrite data already on the profile.
+     *
+     * @param request - Request containing the user ID, optional redirect URL, optional callback URL (receives POST requests), and optional customer identity data
      * @returns Response containing the redirect link and KYC ID
      *
      * @example
@@ -713,7 +753,15 @@ declare class KycClient extends BaseClient {
      * const result = await client.requestKycSubmitLink({
      *   user_id: "user_123",
      *   redirect_url: "https://merchant.com/kyc-complete", // optional
-     *   callback_url: "https://merchant.com/api/kyc-webhook" // optional - receives POST requests on status change
+     *   callback_url: "https://merchant.com/api/kyc-webhook", // optional - receives POST requests on status change
+     *   customer_data: { // optional - seeds the risk profile for document cross-checks
+     *     full_name: "John Doe",
+     *     date_of_birth: "1999-06-02", // ISO 8601
+     *     email: "john@example.com",
+     *     phone: "+94771234567",
+     *     address: "12 Main St, Colombo", // used for address verification
+     *     country: "LK"
+     *   }
      * });
      *
      * console.log(`Redirect user to: ${result.link}`);
@@ -1098,4 +1146,4 @@ declare class KycClient extends BaseClient {
     createCustomerProfile(profile: CreateProfileRequest): Promise<CustomerProfile>;
 }
 
-export { type CheckKycStatusRequest, type CheckKycStatusResponse, CreateProfileRequest as CreateCustomerProfileRequest, type CreateEventBasedFaceVerificationSessionRequest, type CreateEventBasedFaceVerificationSessionResponse, CustomerProfile, ProfileFilters as CustomerProfileFilters, ProfileListResponse as CustomerProfileListResponse, type DocumentType, type DocumentVerificationRequest, type DocumentVerificationResponse, type EventBasedFaceVerificationCallback, type EventBasedFaceVerificationDeviceType, type EventBasedFaceVerificationEvent, type EventBasedFaceVerificationFrequencyTrigger, type EventBasedFaceVerificationReactionResult, type EventBasedFaceVerificationReactions, type EventBasedFaceVerificationThresholdTrigger, type EventBasedFaceVerificationTriggers, type FaceProof, KYC_DECLINED_DESCRIPTIONS, type KycAlert, type KycAlertFilters, type KycAlertListResponse, type KycAlertStatus, type KycAlertType, KycClient, type KycClientConfig, type KycCustomerProfile, type KycDeclinedCode, type KycHandoffSession, type KycOverview, type KycPagination, type KycPreferences, type KycRequest, type KycRequestFilters, type KycRequestListResponse, type KycStatus, type Name, PaginationParams, type Proof, type ProofDownloadURL, type ProofType, type RequestAdditionalDocumentsRequest, type RequestKycSubmitLinkRequest, type RequestKycSubmitLinkResponse, RiskLevel, type SubmitEventBasedFaceVerificationSessionRequest, type SubmittedDocument, type SupportedDocumentType, type UpdateKycAlertRequest, type UpdateKycPreferencesRequest, type UpdateKycStatusRequest, type UseKycAlertsOptions, type UseKycAlertsResult, type UseKycOverviewOptions, type UseKycOverviewResult, type UseKycPreferencesResult, type UseKycRequestsOptions, type UseKycRequestsResult, type UseKycSubmissionOptions, type UseKycSubmissionResult };
+export { type CheckKycStatusRequest, type CheckKycStatusResponse, CreateProfileRequest as CreateCustomerProfileRequest, type CreateEventBasedFaceVerificationSessionRequest, type CreateEventBasedFaceVerificationSessionResponse, CustomerProfile, ProfileFilters as CustomerProfileFilters, ProfileListResponse as CustomerProfileListResponse, type DocumentType, type DocumentVerificationRequest, type DocumentVerificationResponse, type EventBasedFaceVerificationCallback, type EventBasedFaceVerificationDeviceType, type EventBasedFaceVerificationEvent, type EventBasedFaceVerificationFrequencyTrigger, type EventBasedFaceVerificationReactionResult, type EventBasedFaceVerificationReactions, type EventBasedFaceVerificationThresholdTrigger, type EventBasedFaceVerificationTriggers, type FaceProof, KYC_DECLINED_DESCRIPTIONS, type KycAlert, type KycAlertFilters, type KycAlertListResponse, type KycAlertStatus, type KycAlertType, KycClient, type KycClientConfig, type KycCustomerData, type KycCustomerProfile, type KycDeclinedCode, type KycHandoffSession, type KycOverview, type KycPagination, type KycPreferences, type KycRequest, type KycRequestFilters, type KycRequestListResponse, type KycStatus, type Name, PaginationParams, type Proof, type ProofDownloadURL, type ProofType, type RequestAdditionalDocumentsRequest, type RequestKycSubmitLinkRequest, type RequestKycSubmitLinkResponse, RiskLevel, type SubmitEventBasedFaceVerificationSessionRequest, type SubmittedDocument, type SupportedDocumentType, type UpdateKycAlertRequest, type UpdateKycPreferencesRequest, type UpdateKycStatusRequest, type UseKycAlertsOptions, type UseKycAlertsResult, type UseKycOverviewOptions, type UseKycOverviewResult, type UseKycPreferencesResult, type UseKycRequestsOptions, type UseKycRequestsResult, type UseKycSubmissionOptions, type UseKycSubmissionResult };

package/dist/kyc/index.js

@@ -603,7 +603,13 @@ var KycClient = class extends BaseClient {
    *
    * Generates a link that the user can visit to submit their KYC documents.
    *
-   * @param request - Request containing the user ID, optional redirect URL, and optional callback URL (receives POST requests)
+   * Optionally pass the customer's registered identity data as
+   * `customer_data` (same shape as the geolocation `customer_data` block).
+   * It seeds the customer's risk profile so document verification can
+   * cross-check the submitted document against trusted reference data;
+   * fields never overwrite data already on the profile.
+   *
+   * @param request - Request containing the user ID, optional redirect URL, optional callback URL (receives POST requests), and optional customer identity data
    * @returns Response containing the redirect link and KYC ID
    *
    * @example
@@ -611,7 +617,15 @@ var KycClient = class extends BaseClient {
    * const result = await client.requestKycSubmitLink({
    *   user_id: "user_123",
    *   redirect_url: "https://merchant.com/kyc-complete", // optional
-   *   callback_url: "https://merchant.com/api/kyc-webhook" // optional - receives POST requests on status change
+   *   callback_url: "https://merchant.com/api/kyc-webhook", // optional - receives POST requests on status change
+   *   customer_data: { // optional - seeds the risk profile for document cross-checks
+   *     full_name: "John Doe",
+   *     date_of_birth: "1999-06-02", // ISO 8601
+   *     email: "john@example.com",
+   *     phone: "+94771234567",
+   *     address: "12 Main St, Colombo", // used for address verification
+   *     country: "LK"
+   *   }
    * });
    *
    * console.log(`Redirect user to: ${result.link}`);