Buyers

Buyer endpoints let your checkout record a reusable Cordite buyer identifier and check whether that buyer can continue through a regulated purchase flow.

POST /v1/buyers/verify
GET /v1/buyers/:cbid/status

Both routes require bearer auth.

Verify Buyer

{
  "stripe_identity_session_id": "test_session_123",
  "shipping_zip": "90210",
  "test_mode": true
}

Sandbox response:

{
  "cbid": "cbid_test_...",
  "status": "verified",
  "expires_at": "2027-01-01T00:00:00Z",
  "message": "Identity verified. Future purchases at any Cordite-integrated vendor will be instant."
}

Use test_mode for deterministic sandbox checks. Production verification settings are configured per account so buyer identity, address, and eligibility evidence can be retained without exposing raw documents to checkout code.

Buyer Status

curl -s -H "Authorization: Bearer ck_test_..." \
  https://api.cordite.dev/v1/buyers/cbid_test_.../status

Found response:

{
  "cbid": "cbid_test_...",
  "status": "verified",
  "verified_at": "2026-06-24T00:00:00Z",
  "expires_at": "2027-01-01T00:00:00Z"
}

Missing response:

{
  "error": {
    "code": "not_found",
    "message": "Buyer ID not found"
  }
}