Skip to main content
POST
/
api
/
v1
/
transactions
/
wallet
/
{wallet_id}
/
connect
/
verification-document
curl --request POST \
  --url https://hpay-api.host-sl.com/api/v1/transactions/wallet/9a8b7c6d-.../connect/verification-document \
  --header 'api-key: YOUR_API_KEY' \
  --header 'secret-key: YOUR_SECRET_KEY' \
  --form 'document_side=front' \
  --form 'file=@passport.jpg;type=image/jpeg'
{
  "message": "Document (front) uploaded successfully for account acct_1ABC... associated with wallet 9a8b7c6d-....",
  "account_id": "acct_1ABC...",
  "file_id_used": "file_1XYZ...",
  "payouts_enabled": false,
  "currently_due": [],
  "pending_verification": ["individual.verification.document"],
  "disabled_reason": null
}
Uploads the front or back of an identity document (multipart form) and attaches it to the wallet owner’s Connect account. Call this when onboarding reports individual.verification.document in currently_due. Accepted types: JPEG, PNG, PDF. Maximum size: 10 MB.

Path Parameters

wallet_id
string
required
The wallet whose owner’s document is being uploaded.

Form Data

document_side
string
required
front or back.
file
file
required
The document file (JPEG, PNG, or PDF, ≤ 10 MB).

Response

account_id
string
The Stripe Connect account ID.
payouts_enabled
boolean
Whether payouts are now enabled.
pending_verification
string[]
Items Stripe is reviewing (usually includes the just-uploaded document).
{
  "message": "Document (front) uploaded successfully for account acct_1ABC... associated with wallet 9a8b7c6d-....",
  "account_id": "acct_1ABC...",
  "file_id_used": "file_1XYZ...",
  "payouts_enabled": false,
  "currently_due": [],
  "pending_verification": ["individual.verification.document"],
  "disabled_reason": null
}
curl --request POST \
  --url https://hpay-api.host-sl.com/api/v1/transactions/wallet/9a8b7c6d-.../connect/verification-document \
  --header 'api-key: YOUR_API_KEY' \
  --header 'secret-key: YOUR_SECRET_KEY' \
  --form 'document_side=front' \
  --form 'file=@passport.jpg;type=image/jpeg'