Skip to main content

KYC - USD (Fiat)

To operate USD fiat with Avenia, the user must complete USD KYC in addition to standard identity verification.

info

KYC Level 1 must be completed and approved before you can request USD KYC. Complete Level 1 first using the KYC Level 1 guide.

You can request USD KYC from the Avenia dashboard or via the API described below.

The status lifecycle of a USD KYC attempt is the same as for KYC Level 1 (for example PENDING, PROCESSING, COMPLETED, with result APPROVED or REJECTED). Track progress with List All KYC Attempts and Get KYC Attempt by ID in the KYC Level 1 guide. If webhooks are enabled for your account, you will receive the same KYC event types as for other KYC flows.

Request USD KYC via API​

Use this endpoint to start a USD KYC request programmatically. No request body is required.

HTTP POST Request:​

https://api.sandbox.avenia.io:10952/v2/kyc/usd/api

Query parameters​

ParameterTypeRequiredDescription
subAccountIdstringNoWhen requesting USD KYC for a subaccount, pass the subaccount ID as a query parameter.

cURL Example (main account)​

curl -X POST "https://api.sandbox.avenia.io:10952/v2/kyc/usd/api" \
     -H "Authorization: Bearer eyJhdXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"

cURL Example (subaccount)​

curl -X POST "https://api.sandbox.avenia.io:10952/v2/kyc/usd/api?subAccountId=1ee0a663-922b-4389-9f84-074ccff7085d" \
     -H "Authorization: Bearer eyJhdXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
tip

For subaccounts, the same subAccountId query parameter pattern applies when listing or fetching KYC attempts for that user.

  • KYC Level 1 — document upload, selfie / liveness, Web SDK, and shared KYC attempt APIs
  • Webhook events — KYC subscription and event types