Verification Methods
The Transcrypts SDK widget supports five verification methods. Each method connects to a different data source to retrieve employment and income information.Bank Integration
Applicants connect their bank accounts through the widget to verify income. Transaction and deposit history from linked accounts provides proof of income.Payroll Integration
Applicants connect their payroll provider through the widget. Employment details, salary information, and pay history are retrieved directly from the payroll system.Social Security Account
Applicants connect to the Social Security Administration (SSA) website through the widget. SSA records provide a verified employment history across all employers that reported wages.Stored Credentials
Applicants who have previously completed verification through Transcrypts can reuse their stored credentials. This method skips the initial connection step and retrieves data using existing authorized access.Instant Verification
The verifier provides the applicant’s name, date of birth, and address history. Transcrypts returns results immediately by matching this information against available data sources without requiring applicant interaction.Supported Environments
Transcrypts operates across two environments:- Development: For live credential testing; limited to 50 successful Tasks without billing
- Production: For production use; each successful Task incurs charges
https://prod.transcrypts.com/v1/ regardless of environment. The Access secret determines which environment processes each request.
Authentication
API Keys
The Transcrypts API requires valid credentials consisting of:
The
client_id remains constant across environments. The access_secret differs for each environment with prefixes: dev or prod.
Required Headers
Every API request requires:X-Access-Client-ID: Contains the Client IDX-Access-Secret: Contains the Access secret
Protocols
Transcrypts uses REST API frameworks with these specifications:- Responses in standard JSON format
- HTTPS TLS v1.2+ required (HTTP and earlier TLS versions unsupported)
- Requests must include
Content-Type: application/jsonheader with valid JSON body only
Security
Manage identifier values from Transcrypts Bridge and API endpoints to maximize security. These values associate API and provider events with requests and assist support teams with issue resolution.Additional Access Tokens
Users with multiple data provider accounts and Links may create multipleaccess_tokens.
Errors
HTTP Status Codes
2xx: Successful requests4xx: Invalid inputs or state violations5xx: Rare server errors
Response Code Reference
Error Message Format
Response bodies contain:code: Error sourcemessage: User-facing issue descriptioninvalid-params: Form field errors withfieldparameter for UI display
Error Code Types
validation_error: Invalid input format or missing required fieldsexpired_token: Public token expired after 6 hoursincorrect_token: Public or access token cannot be matched in storage
Rate Limiting
The API allows up to 300 requests per minute per Access secret key. Exceeding this limit returns a429 Too Many Requests error. Contact support@transcrypts.com to request limit increases.