PassifyDocs

Quickstart

Go from zero to a verified, portable attestation in four requests. This walkthrough uses cURL; the same calls work from any HTTP client.

Prerequisites

  • A Passify account and an API key (create one in the dashboard under Keys).
  • The investor's Solana wallet address (a base58 public key).
  • Any HTTP client — cURL, Postman, or your backend language of choice.

1. Authenticate

Pass your API key as a bearer token in the Authorization header. Keys are shown once at creation — store them in a secret manager, never in client-side code.

bash
curl https://passify.biz/api/v1/health \
  -H "Authorization: Bearer passify_live_xxx"

2. Start a KYC session

Create a verification session for the investor's wallet. Choose the schema that matches what you need to prove — kyc_individual_v1 for basic identity, kyc_accredited_v1 for accredited-investor checks.

bash
curl -X POST https://passify.biz/api/v1/kyc/start \
  -H "Authorization: Bearer passify_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "userPubkey": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",
    "schemaId": "kyc_individual_v1"
  }'

The response contains a hosted verification URL:

200 OK
{
  "session_id": "sess_9x2k",
  "session_url": "https://verify.blockpass.org/..."
}

3. Redirect the investor

Send the investor to session_url. They complete identity verification with our KYC partner — uploading documents and a selfie. That data goes to the provider, never to Passify. When verification finishes, the provider notifies Passify by webhook and an attestation is written on-chain.

4. Check attestation status

Read verification status for the wallet at any time:

bash
curl https://passify.biz/api/v1/kyc/status/7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU \
  -H "Authorization: Bearer passify_live_xxx"
200 OK
{
  "status": "verified",
  "attestation_id": "att_5m8n",
  "schema": "kyc_individual_v1",
  "expires_at": "2026-12-15T00:00:00Z",
  "onchain_tx": "3kLm...xyz"
}

That attestation is now portable. Any platform integrated with Passify can read the same proof for this wallet — no repeat KYC.

Next steps

Last updated

Related pages