Crypto-as-a-Service: Complete KYB Verification

// 1. Create Enterprise and Primary User
export ORGANIZATION_ID="<YOUR_ORGANIZATION_ID>"
export SERVICE_USER_TOKEN="<SERVICE_USER_ACCESS_TOKEN>"
export EMAIL="<YOUR_USER_EMAIL>"
export IDEMPOTENCY_KEY="<UUID_V4>"

curl -X POST \
  "https://app.bitgo-test.com/api/v2/organization/$ORGANIZATION_ID/enterprise" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $SERVICE_USER_TOKEN" \
  -d '{
    "email": "'"$EMAIL"'",
    "idempotencyKey": "'"$IDEMPOTENCY_KEY"'",
    "additionalAdmins": [],
    "accountType": "entity"
  }'

// 2. Create Users for Associated Persons
export ENTERPRISE_ID="<YOUR_ENTERPRISE_ID>"
export EMAIL="<YOUR_USER_EMAIL>"

curl -X POST \
  "https://app.bitgo-test.com/api/v2/organization/$ORGANIZATION_ID/enterprise/$ENTERPRISE_ID/user" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $SERVICE_USER_TOKEN" \
  -d '{
    "email": "'"$EMAIL"'"
  }'

// 3. Set Up Business Identity
// 3.1 Create Business Identity

export BUSINESS_IDENTITY_ID="<YOUR_BUSINESS_IDENTITY_ID>"

curl -X POST \
  "https://app.bitgo-test.com/api/identity-service/v1/identities" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $SERVICE_USER_TOKEN" \
  -d '{
    "type": "business",
    "enterpriseId": "'"$ENTERPRISE_ID"'",
    "organizationId": "'"$ORGANIZATION_ID"'",
    "requestedProducts": [
      {
        "name": "Trade",
        "bitgoOrg": "BitGo Trust"
      },
      {
        "name": "Go Account",
        "bitgoOrg": "BitGo Trust"
      }
    ]
  }'

// 3.2 Add Business Location and Legal Entity Structure
curl -X PATCH \
  "https://app.bitgo-test.com/api/identity-service/v1/identities/$BUSINESS_IDENTITY_ID" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $SERVICE_USER_TOKEN" \
  -d '{
    "business": {
      "physicalBusinessAddress": {
        "street1": "123 4th St",
        "city": "San Francisco",
        "subdivision": "CA",
        "zip": "94103",
        "country": "USA"
      },
      "legalEntityStructure": "corporationCAndS",
      "primaryBusinessType": "Crypto Services (Exchange, ATM, Borrow/Lend)",
      "incorporationCountryCode": "USA",
      "primaryOperationsCountryCode": "USA"
    }
  }'

// 4. Set Up Associated Persons
// 4.1 Create Individual Identities for Associated Persons
export ASSOCIATED_PERSON_USER_ID="<USER_ID_FOR_THIS_ASSOCIATED_PERSON>"
export INDIVIDUAL_IDENTITY_ID="<YOUR_INDIVIDUAL_IDENTITY_ID>"

curl -X POST \
  "https://app.bitgo-test.com/api/identity-service/v1/identities" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $SERVICE_USER_TOKEN" \
  -d '{
    "type": "individual",
    "userId": "'"$ASSOCIATED_PERSON_USER_ID"'",
    "requestedProducts": []
  }'

// 4.2 Add Associated Persons to Business Identity

curl -X PATCH \
  "https://app.bitgo-test.com/api/identity-service/v1/identities/$BUSINESS_IDENTITY_ID" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $SERVICE_USER_TOKEN" \
  -d '{
    "associatedPeople": [
      {
        "role": "beneficialOwner",
        "identityId": "<BENEFICIAL_OWNER_IDENTITY_ID>",
        "percentageOwnership": 25
      },
      {
        "role": "controlPerson",
        "identityId": "<CONTROL_PERSON_IDENTITY_ID>"
      }
    ]
  }'

// 4.3 Update Associated Persons with Location Information
curl -X PATCH \
  "https://app.bitgo-test.com/api/identity-service/v1/identities/$INDIVIDUAL_IDENTITY_ID" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $SERVICE_USER_TOKEN" \
  -d '{
    "individual": {
      "countryOfResidence": "USA",
      "countryOfCitizenship": "USA"
    }
  }'

// 4.4 Update Individual Identities with Required Information
curl -X PATCH \
  "https://app.bitgo-test.com/api/identity-service/v1/identities/$INDIVIDUAL_IDENTITY_ID" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $SERVICE_USER_TOKEN" \
  -d '{
    "individual": {
      "nameFirst": "John",
      "nameLast": "Doe",
      "email": "john.doe@acme.com",
      "birthdate": {
        "month": "01",
        "day": "01",
        "year": "2000"
      },
      "identificationNumber": "12345678",
      "phoneNumber": {
        "countryCode": "1",
        "phoneNumber": "5559876543"
      },
      "occupation": "Other",
      "countryOfResidence": "USA",
      "countryOfCitizenship": "USA",
      "address": {
        "street1": "123 4th St",
        "city": "San Francisco",
        "subdivision": "CA",
        "zip": "94103",
        "country": "USA"
      },
      "politicallyExposedPerson": false
    }
  }'

// 4.5 Remove an Associated Person (Optional)
export ASSOCIATED_PERSON_ID="<ASSOCIATED_PERSON_ID>"

curl -X DELETE \
  "https://app.bitgo-test.com/api/identity-service/v1/identities/$BUSINESS_IDENTITY_ID/associated-people/$ASSOCIATED_PERSON_ID" \
  -H "Authorization: Bearer $SERVICE_USER_TOKEN"

// 5. Upload Required Documents
// 5.1 Identify Business Type and Documents
// Review the requirements array for entries with kind: "document".

// 5.2 Generate Document Upload URL
export DOCUMENT_ID="<YOUR_DOCUMENT_ID>"

curl -X POST \
  "https://app.bitgo-test.com/api/document-service/v1/documents" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $SERVICE_USER_TOKEN" \
  -d '{
    "documentType": "w9"
  }'

// 5.3 Upload Document
export UPLOAD_URL="<DOCUMENT_UPLOAD_URL>"
export FILE_PATH="</path/to/your/document.pdf>"
export CONTENT_TYPE="application/pdf"

curl -X POST "$UPLOAD_URL" \
  -F "file=@$FILE_PATH;type=$CONTENT_TYPE"

// 5.4 Verify Document
curl -X POST \
  "https://app.bitgo-test.com/api/document-service/v1/documents/$DOCUMENT_ID/verify" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $SERVICE_USER_TOKEN" \
  -d '{}'

// 5.5 Associate Documents with Identity
export IDENTITY_ID="<YOUR_IDENTITY_ID>"

curl -X POST \
  "https://app.bitgo-test.com/api/identity-service/v1/identities/$IDENTITY_ID/documents" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $SERVICE_USER_TOKEN" \
  -d '{
    "documents": [
      {
        "documentId": "'"$DOCUMENT_ID"'",
        "documentType": "w9",
        "documentSubType": null
      }
    ]
  }'

// 5.6 Update Document Association (Optional)
export IDENTITY_DOCUMENT_ID="<IDENTITY_DOCUMENT_ID>"
export NEW_DOCUMENT_ID="<NEW_DOCUMENT_SERVICE_ID>"

curl -X PUT \
  "https://app.bitgo-test.com/api/identity-service/v1/identities/$IDENTITY_ID/documents/$IDENTITY_DOCUMENT_ID" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $SERVICE_USER_TOKEN" \
  -d '{
    "documentId": "'"$NEW_DOCUMENT_ID"'",
    "documentType": "w9"

  }'

// 6. Check Statuses
export IDENTITY_ID="<BUSINESS_IDENTITY_ID>"

curl -X GET \
  "https://app.bitgo-test.com/api/identity-service/v1/identities/$IDENTITY_ID" \
  -H "Authorization: Bearer $SERVICE_USER_TOKEN"

// 7. Finalize Submission
curl -X PATCH \
  "https://app.bitgo-test.com/api/identity-service/v1/identities/$IDENTITY_ID" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $SERVICE_USER_TOKEN" \
  -d '{
    "finalizeSubmission": true
  }'

// 8. Sign Contracts
export CONTRACT_ID="<CONTRACT_ID>"

curl -X POST \
  "https://app.bitgo-test.com/api/v2/organization/$ORGANIZATION_ID/enterprise/$ENTERPRISE_ID/contract" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $SERVICE_USER_TOKEN" \
  -d '{
    "contractType": "master-agreement",
    "contractId": "'"$CONTRACT_ID"'"
  }'