vesant-sdk 1.7.1-dev.ec505dc → 1.7.1-dev.f42297f

package/dist/kyc/index.d.mts

@@ -11,7 +11,11 @@ import { B as BaseClient, R as RequestOptions } from '../client-q9fN8Hhf.mjs';
  * - services/kyc-service/internal/handler/
  */
 
-type KycStatus = 'pending' | 'accepted' | 'declined' | 'review.pending' | 'unknown';
+type KycStatus = 
+/** Submit link issued but the customer has not submitted documents yet — not "in progress". */
+'awaiting_kyc'
+/** Documents submitted, verification in progress. */
+ | 'pending' | 'accepted' | 'declined' | 'review.pending' | 'unknown';
 type KycDeclinedCode = 'KYC_DOCUMENT_EXPIRED' | 'KYC_DOCUMENT_INVALID' | 'KYC_FACE_MISMATCH' | 'KYC_AGE_REQUIREMENT' | 'KYC_DUPLICATE_IDENTITY' | 'KYC_ADDRESS_MISMATCH' | 'KYC_NAME_MISMATCH' | 'KYC_PROVIDER_REJECTED' | 'KYC_DECLINED';
 declare const KYC_DECLINED_DESCRIPTIONS: Record<KycDeclinedCode, string>;
 type KycAlertStatus = 'pending' | 'in_progress' | 'resolved' | 'closed' | 'escalated';
@@ -539,17 +543,22 @@ interface KycHandoffSession {
     is_submitted: boolean;
 }
 interface CheckKycStatusRequest {
-    /** User ID to check KYC status for */
+    /** Customer identifier. Sent for context only — the lookup is by kyc_id. */
     user_id: string;
-    /** Authentication token */
+    /** The KYC request ID returned by requestKycSubmitLink; drives the status lookup. */
     kyc_id: string;
 }
 /**
  * Response from checkKycStatus. Always returns the same shape.
  *
- * `additional_data` is `null` when `status === 'pending'`.
- * When `status !== 'pending'`, `additional_data` contains the full KYC record
- * including document details, proofs, and the customer's risk profile.
+ * `additional_data` is `null` when `status` is `'awaiting_kyc'` or `'pending'`.
+ * Otherwise it contains the full KYC record including document details,
+ * proofs, and the customer's risk profile.
+ *
+ * `status === 'awaiting_kyc'` means the submit link was issued but the
+ * customer has not submitted documents — treat it as "not started", never as
+ * "in progress". Check `link_expired`: `false` → re-surface the existing
+ * link; `true` → request a fresh one via `requestKycSubmitLink`.
  */
 interface CheckKycStatusResponse {
     id: string;
@@ -578,8 +587,12 @@ interface CheckKycStatusResponse {
     is_address_verification_required: boolean;
     is_age_verification_required: boolean;
     created_at: string;
-    /** Full KYC record with document details, proofs, and risk profile. Null when status is 'pending'. */
+    /** Full KYC record with document details, proofs, and risk profile. Null when status is 'awaiting_kyc' or 'pending'. */
     additional_data: KycRequest | null;
+    /** Present when status is 'awaiting_kyc': whether the submit link has expired (request a new one when true). */
+    link_expired?: boolean;
+    /** Present when status is 'awaiting_kyc': the submit link's expiry time (RFC 3339). */
+    link_expires_at?: string;
 }
 interface RequestAdditionalDocumentsRequest {
     /** KYC request ID */

package/dist/kyc/index.d.ts

@@ -11,7 +11,11 @@ import { B as BaseClient, R as RequestOptions } from '../client-q9fN8Hhf.js';
  * - services/kyc-service/internal/handler/
  */
 
-type KycStatus = 'pending' | 'accepted' | 'declined' | 'review.pending' | 'unknown';
+type KycStatus = 
+/** Submit link issued but the customer has not submitted documents yet — not "in progress". */
+'awaiting_kyc'
+/** Documents submitted, verification in progress. */
+ | 'pending' | 'accepted' | 'declined' | 'review.pending' | 'unknown';
 type KycDeclinedCode = 'KYC_DOCUMENT_EXPIRED' | 'KYC_DOCUMENT_INVALID' | 'KYC_FACE_MISMATCH' | 'KYC_AGE_REQUIREMENT' | 'KYC_DUPLICATE_IDENTITY' | 'KYC_ADDRESS_MISMATCH' | 'KYC_NAME_MISMATCH' | 'KYC_PROVIDER_REJECTED' | 'KYC_DECLINED';
 declare const KYC_DECLINED_DESCRIPTIONS: Record<KycDeclinedCode, string>;
 type KycAlertStatus = 'pending' | 'in_progress' | 'resolved' | 'closed' | 'escalated';
@@ -539,17 +543,22 @@ interface KycHandoffSession {
     is_submitted: boolean;
 }
 interface CheckKycStatusRequest {
-    /** User ID to check KYC status for */
+    /** Customer identifier. Sent for context only — the lookup is by kyc_id. */
     user_id: string;
-    /** Authentication token */
+    /** The KYC request ID returned by requestKycSubmitLink; drives the status lookup. */
     kyc_id: string;
 }
 /**
  * Response from checkKycStatus. Always returns the same shape.
  *
- * `additional_data` is `null` when `status === 'pending'`.
- * When `status !== 'pending'`, `additional_data` contains the full KYC record
- * including document details, proofs, and the customer's risk profile.
+ * `additional_data` is `null` when `status` is `'awaiting_kyc'` or `'pending'`.
+ * Otherwise it contains the full KYC record including document details,
+ * proofs, and the customer's risk profile.
+ *
+ * `status === 'awaiting_kyc'` means the submit link was issued but the
+ * customer has not submitted documents — treat it as "not started", never as
+ * "in progress". Check `link_expired`: `false` → re-surface the existing
+ * link; `true` → request a fresh one via `requestKycSubmitLink`.
  */
 interface CheckKycStatusResponse {
     id: string;
@@ -578,8 +587,12 @@ interface CheckKycStatusResponse {
     is_address_verification_required: boolean;
     is_age_verification_required: boolean;
     created_at: string;
-    /** Full KYC record with document details, proofs, and risk profile. Null when status is 'pending'. */
+    /** Full KYC record with document details, proofs, and risk profile. Null when status is 'awaiting_kyc' or 'pending'. */
     additional_data: KycRequest | null;
+    /** Present when status is 'awaiting_kyc': whether the submit link has expired (request a new one when true). */
+    link_expired?: boolean;
+    /** Present when status is 'awaiting_kyc': the submit link's expiry time (RFC 3339). */
+    link_expires_at?: string;
 }
 interface RequestAdditionalDocumentsRequest {
     /** KYC request ID */