Swipelux
Individual Onboarding

Status & Workflow

Track individual verification status from creation to approval or rejection.

Verification Status & Workflow

Verification Status Values

StatusDescription
not_startedCustomer created; KYC has not started
incompleteKYC started, but required information is missing
pending_verificationKYC initiated and waiting for customer completion
under_reviewDocuments submitted and under compliance review
approvedKYC approved; the customer can use approved flows
rejectedKYC rejected; review the reason and next steps

Standard KYC Workflow

1. Create Customer (POST /v1/customers)
   └── Status: not_started

2. Initiate KYC (POST /v1/customers/{id}/kyc)
   └── Status: pending_verification
   └── Returns: verificationUrl

3. Customer Completes Verification
   └── Visits verificationUrl
   └── Uploads ID document
   └── Completes selfie/liveness check

4. Automatic Review
   └── Status: under_review

5. Approval/Rejection
   └── Status: approved OR rejected

Enhanced KYC Workflow

When enhanced verification is triggered, the flow usually adds a manual document review:

1. Standard KYC Completed
   └── Status: approved (with limitations) OR under_review

2. Enhanced Documents Required
   └── Status changes to: under_review
   └── Compliance team notified

3. Customer Notification
   └── Email sent to customer's registered email
   └── Request for additional documents:
       - Proof of address
       - Proof of funds

4. Document Submission
   └── Customer responds to compliance email
   └── Documents reviewed by compliance team

5. Final Decision
   └── Status: approved (full access) OR rejected

Enhanced KYC document requests are currently handled via direct email communication from our compliance team to the customer's registered email address.


Webhooks

Subscribe to verification status changes with webhooks:

Event: customer.verification_changed

{
  "type": "customer.verification_changed",
  "data": {
    "customerId": "cus_abc123",
    "customerType": "individual",
    "verificationStatus": "approved",
    "previousStatus": "pending"
  },
  "createdAt": 1704067200000
}

Common Rejection Reasons

ReasonResolution
Document not readableRe-upload a clear, high-resolution image
Document expiredProvide a valid, non-expired ID document
Face not matchingEnsure selfie clearly matches ID photo
Incomplete informationProvide all required fields
Suspicious activityContact support for manual review

Verification Timeline

StageTypical Duration
Document UploadImmediate
Automated Checks1-3 minutes
Standard Review1-24 hours
Enhanced Review1-3 business days

Support

For KYC questions or issues:

On this page