Swipelux
Individual Onboarding

Status & Workflow

Verification status values and KYC workflow diagrams

Verification Status & Workflow

Verification Status Values

StatusDescription
not_startedCustomer created, no KYC process begun
incompleteKYC started but missing required information
pending_verificationKYC initiated, awaiting customer completion
under_reviewDocuments submitted, under compliance review
approvedKYC approved, customer can transact
rejectedKYC rejected (see rejection reasons)

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 following process occurs:

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 via webhooks:

Event: customer.verification.updated

{
  "event": "customer.verification.updated",
  "data": {
    "customerId": "cust_abc123",
    "previousStatus": "pending_verification",
    "currentStatus": "approved",
    "timestamp": "2024-01-15T14:30:00Z"
  }
}

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-related questions or issues:

On this page