Crypto-as-a-Service: Complete KYC Verification (EU Unregulated)
Verify your EU end users with KYC and IDV, including the deposit-verification flow. See the Guide.
-
You submit basic KYC information for your EU end user with
transactionType: "euIndividual". BitGo returns the identityid.initialKycCompletionDateandlastKycCompletionDaterecord when your organization completed KYC for the end user. ThelastKycCompletionDatemust be within the last two years of the request.API Reference: Create KYC Identity
-
You start the IDV process and receive a BitGo-hosted verification link for your end user. Pass
verificationType: "deposit-verification"for the in-house deposit flow. The end user completes a liveness check, then sends a SEPA transfer of any amount above €0.01 to a per-client vIBAN. BitGo emits abankAccountwebhook when the vIBAN is ready. Fetch the deposit instructions with the Get vIBAN Deposit Info endpoint. The end user can send a new deposit to the same vIBAN for up to 30 days.The cURL tab also includes the request for reusing an existing Sumsub applicant with a
sumsubShareToken.API Reference: Initiate Sumsub IDV for a user
-
For deposit verifications, BitGo creates a unique virtual IBAN (vIBAN) for the enterprise. You can receive a notification when the vIBAN is ready by creating a
bankAccountwebhook, or by polling this endpoint. The response returns the vIBAN information for the deposit verification. Pass the details to your end user so they can initiate a SEPA transfer of any amount above €0.01. Allow up to 24 hours for the deposit to settle. If the deposit is rejected, BitGo returns the funds. Common rejection reasons includeThird-Party Account,Duplicate Account, andTimeout. Your end users can retry depositing to the same vIBAN for up to 30 days. If no accepted deposit arrives in that window, BitGo declines the identity.API Reference: Get deposit verification info
-
You poll the IDV status for your end user. BitGo also sends status changes to your
idvStatuswebhook.API Reference: Get Sumsub IDV status
-
If an end user's IDV is in
pendingoraction_requiredstate, you can switch them to another verification type and receive a fresh verification link. Switching todeposit-verificationisn't available.API Reference: Switch verification flow for an existing IDV
-
You poll the KYC status to determine next steps. The status moves through
initiating,in review,awaiting signature, and ends atapprovedordeclined.API Reference: Get KYC Identity
-
When the KYC status is
awaiting signature, your end user signs to confirm. The requiredcontractTypevalues depend on your organization's agreements with BitGo.API Reference: Submit KYC Signatures
// 1. Submit KYC
export SERVICE_USER_TOKEN="<SERVICE_USER_ACCESS_TOKEN>"
export ORGANIZATION_ID="<YOUR_ORGANIZATION_ID>"
curl -X POST \
https://app.bitgo-test.com/api/evs/v1/identity \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $SERVICE_USER_TOKEN" \
-d '{
"enterpriseId": "59cd72485007a239fb00282ed480da1f",
"userId": "67d28e3dea178ede86f2962e959865a0",
"organizationId": "'"$ORGANIZATION_ID"'",
"externalUserId": "external-user-hans-mueller-001",
"transactionType": "euIndividual",
"nameFirst": "Hans",
"nameLast": "Müller",
"dateOfBirth": {
"year": "1985",
"month": "06",
"day": "15"
},
"cityOfBirth": "Frankfurt am Main",
"countryOfBirth": "DEU",
"countryOfCitizenship": "DEU",
"countryOfResidence": "DEU",
"taxId": "12345678901",
"countryOfTaxResidence": "DEU",
"industry": "Software & IT Services",
"employmentStatus": "Employee",
"sourceOfFunds": "Income from Employment",
"email": "hans.mueller@example.com",
"phoneNumber": "+4969123456789",
"politicallyExposedPerson": false,
"idvPerformed": false,
"initialKycCompletionDate": {
"year": "<INITIAL_KYC_YEAR>",
"month": "<INITIAL_KYC_MONTH>",
"day": "<INITIAL_KYC_DAY>"
},
"lastKycCompletionDate": {
"year": "<LAST_KYC_YEAR_WITHIN_2_YEARS>",
"month": "<LAST_KYC_MONTH>",
"day": "<LAST_KYC_DAY>"
},
"addressStreet1": "Mainzer Landstraße 50",
"addressCity": "Frankfurt am Main",
"addressPostalCode": "60325",
"debugStatus": "passed",
"debugFailureReason": ""
}'
// 2.1 Initiate IDV
curl -X POST \
https://app.bitgo-test.com/api/sumsub-service/v1/idv \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $SERVICE_USER_TOKEN" \
-d '{
"userId": "<END_USER_USER_ID>",
"enterpriseId": "'"$ENTERPRISE_ID"'",
"verificationType": "<VERIFICATION_TYPE>"
}'
// 2.2 Get vIBAN Deposit Info
export ENTERPRISE_ID="<CHILD_ENTERPRISE_ID>"
export ACCESS_TOKEN="<SERVICE_USER_ACCESS_TOKEN>"
curl -X GET \
"https://app.bitgo-test.com/api/tradfi/v1/deposit-verification/$ENTERPRISE_ID/deposit-info" \
-H "Authorization: Bearer $ACCESS_TOKEN"
// 2.3 Check IDV Status (Optional)
export IDV_ID="<IDV_ID>"
curl -X GET \
"https://app.bitgo.com/api/sumsub-service/v1/idv/$IDV_ID" \
-H "Authorization: Bearer $SERVICE_USER_TOKEN"
// 2.4 Switch Verification Type (Optional)
curl -X POST \
"https://app.bitgo.com/api/sumsub-service/v1/idv/$IDV_ID/change-verification-type" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $SERVICE_USER_TOKEN" \
-d '{
"verificationType": "video-id"
}'
// 3. Check KYC Status (Optional)
export ENTERPRISE_ID="<CHILD_ENTERPRISE_ID>"
export IDENTITY_ID="<END_USER_IDENTITY_ID>"
curl -X GET \
"https://app.bitgo-test.com/api/evs/v1/identity?organizationId=$ORGANIZATION_ID&enterpriseId=$ENTERPRISE_ID&identityId=$IDENTITY_ID" \
-H "Authorization: Bearer $SERVICE_USER_TOKEN"
// 4. Sign Completed KYC
curl -X POST \
"https://app.bitgo-test.com/api/evs/v1/identity/$IDENTITY_ID/signatures" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $SERVICE_USER_TOKEN" \
-d '[
{
"contractSignerNameFull": "Hans Müller",
"contractSignedDate": "2025-03-13 13:14:09.767480+00:00",
"contractSignedIPAddress": "123.123.123.123",
"contractVersion": "1.0",
"contractType": "<EU_CONTRACT_TYPE>",
"userAgreesToTerms": true
}
]'
// 1. Submit KYC
// Use the cURL tab for this step
// 2.1 Initiate IDV
// Use the cURL tab for this step
// 2.2 Get vIBAN Deposit Info
// Use the cURL tab for this step
// 2.3 Check IDV Status (Optional)
// Use the cURL tab for this step
// 2.4 Switch Verification Type (Optional)
// Use the cURL tab for this step
// 3. Check KYC Status (Optional)
import superagent from 'superagent';
const SERVICE_USER_TOKEN = '<SERVICE_USER_ACCESS_TOKEN>';
const organizationId = '<YOUR_ORGANIZATION_ID>';
const enterpriseId = '<CHILD_ENTERPRISE_ID>';
const identityId = '<END_USER_IDENTITY_ID>';
const apiUrl = `https://app.bitgo-test.com/api/evs/v1/identity?organizationId=${organizationId}&enterpriseId=${enterpriseId}&identityId=${identityId}`;
const response = await superagent
.get(apiUrl)
.set('Authorization', `Bearer ${SERVICE_USER_TOKEN}`);
// 4. Sign Completed KYC
// 1. Submit KYC Response
{
"id": "993ec85b-ad23-4259-bde5-703a071a0783",
"status": "initiating"
}
// 2.1 Initiate IDV Response
{
"idvId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"status": "pending",
"url": "https://verify.example.com/p/abc123...",
"expiresAt": "2026-05-01T12:00:00Z"
}
// 2.3 Check IDV Status (Optional) Response
{
"idvId": "98f20884-f3ce-4949-a969-4a6010ae00e1",
"status": "approved",
"verificationType": "deposit-verification",
"userId": "69fce210ac533caa20ef5bdcfc2ef3d4",
"enterpriseId": "69fce212ac533caa20ef5c13ff183e84",
"organizationId": "69e291d44afc2b668a3ac76d16fef106",
"rejectLabels": null
}
// 2.4 Switch Verification Type (Optional) Response
{
"url": "https://verify.example.com/p/xyz789...",
"expiresAt": "2026-05-01T12:00:00Z"
}
// 3. Check KYC Status (Optional) Response
{
"identities": [
{
"id": "5436ff2e-1129-49f1-8334-1510955ffe00",
"status": "in review",
"organizationId": "68928b9066417fe09212fe9965c88552",
"enterpriseId": "690a234346b3252214cdaf72070c549e",
"userId": "690a234046b3252214cdadfe8600df80",
"createdAt": "2025-11-04T16:05:15.359Z",
"updatedAt": "2025-11-04T16:05:17.975Z",
"signaturesSubmitted": [],
"signaturesRequired": []
}
]
}
// 4. Sign Completed KYC Response
{
"id": "cf5d766d-bef1-4874-8b02-54ded0e8333e",
"status": "signature submitted",
"organizationId": "6573806ef79cafdd1aff42fbffc2ab20",
"enterpriseId": "67d28e40ea178ede86f296ac90032286",
"userId": "67d28e3dea178ede86f2962e959865a0",
"updatedAt": "2025-03-13T07:59:52.564Z",
"createdAt": "2025-03-13T07:54:18.842Z",
"errorDescription": "",
"signaturesSubmitted": ["<CONTRACT_TYPE_1>", "<CONTRACT_TYPE_2>"],
"signaturesRequired": []
}
// 2.2 Get vIBAN Deposit Info Response
{
"data": [
{
"id": "9f5b3c2a1d4e8f7a6b0c2d1e3f4a",
"idHash": "cd303c82c4c74abf",
"type": "sepa",
"currency": "tfiateur",
"name": "Deposit Verification vIBAN",
"shortCountryCode": "DE",
"accountNumber": "DE89370400440532013000",
"enterpriseId": "67d28e40ea178ede86f296ac90032286",
"trustOrg": "BitGo Europe ApS",
"ownerName": "Hans Müller",
"verificationState": "approved",
"swiftCode": "COBADEFFXXX",
"accountType": "checking",
"createdAt": "2026-05-01T12:00:00.000Z"
}
],
"page": {
"limit": 100,
"more": false,
"offset": 0
}
}