Trigger Customer TIN Step-Up
For an already-approved customer, moves their existing KYC
onto a TIN-only step-up level and returns a fresh verification
link. Hand the returned url to the customer to collect their tax
identification number status. No-ops with a 409 if the customer already
has a TIN on file.
Authorizations
API Key
Headers
a UUID ensuring a TIN step-up trigger is only processed once
Optional sub-partner UUID, if provided, the step-up will be triggered for the sub-partner's customer
Selects the API version for this request, as an ISO date (YYYY-MM-DD). Omit to use the default version (2025-03-13). Supported versions: 2025-03-13, 2026-07-01, 2026-08-01.
Path Parameters
the ID of the Customer to trigger a TIN step-up for
Response
POST Trigger Customer TIN Step-Up Succeeded
Identification
The entity wrapping our KYC/KYB process and underlying providers
The Process status of the identification
The various state transitions an identification can go through.
Pending, Processed, PendingReview, Approved, Declined, Expired, Archived Absent on a referral partner's identification (partner-keyed record)
The owning partner for partner-keyed (referral) records
ISO 3166-1 alpha-2 (2 letter) country code of the verified residence address; only set on the customer's most recent identification while it is approved
- BusinessIdentificationStepStatus
- PersonIdentificationStepStatus