Skip to main content

Testing Your Integration

Practical steps to validate your integration end‑to‑end.

Prerequisites​

  • API access (key if required)
  • Sample documents (ID front/back, utility bill, payslip)
  • REST client (curl or Postman)

Smoke Tests​

  1. Health check
curl -s https://api.botskyc.com/api/kyc/health
  1. Identity verification (single image)
curl -X POST https://api.botskyc.com/api/kyc/analyze/identity \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: multipart/form-data" \
  -F "documents=@omang-front.jpg"
  1. Identity verification (front+back)
curl -X POST https://api.botskyc.com/api/kyc/analyze/identity \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: multipart/form-data" \
  -F "documents=@omang-front.jpg" \
  -F "documents=@omang-back.jpg"

Liveness Flow​

Verify combined:

curl -X POST https://api.botskyc.com/api/kyc/analyze/identity-with-liveness \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "files=@omang-front.jpg" \
  -F "files=@omang-back.jpg" \
  -F "liveness_session_id=YOUR_SESSION_ID"

Using Postman​

Troubleshooting​

  • 400: Check file field names and content type
  • 401: Verify Authorization header
  • 404: Ensure correct path and sessionId
  • 429: Backoff and retry (respect rate limits)
  • 500: Retry with jitter; contact support if persistent