Unlock foreign currency capability
After Avenia approves a foreign KYC profile, submit the currency unlock request for USD. Pods forwards the unlock to Avenia, refreshes account metadata, and returns the normalized KYC status including usdEnabled. Idempotent when the capability is already enabled.
Authorizations
API key for authentication. Obtain from your Pods dashboard.
Body
Request Avenia currency unlock for an approved foreign KYC profile
Response
Currency unlock submitted or already enabled
Current normalized KYC profile status
Pods-generated public KYC user id
"550e8400-e29b-41d4-a716-446655440000"
KYC provider used for the profile. external_evidence means the capture was performed by the customer and submitted to Pods as attested evidence.
sumsub, bigdatacorp, external_evidence "sumsub"
Wallet address stored on the Ramp KYC profile. Accepts a checksummed EVM address or a Solana public key. Later Pix quotes must use the same address as destinationAddress (onramp) or originAddress (offramp).
"EXYhCNamLPFfSMekSn7Lzc2cP32aZpRa7ok5gErdJzcj"
Normalized Pods KYC status
created, provider_pending, approved, rejected, rejected_retryable, blocked "provider_pending"
false
True when the profile is approved for USD WIRE/ACH ramps via Avenia
false
Reserved for a future EUR capability; always false today
false
"COMPLETED"
Provider-specific normalized result. BigDataCorp may return values such as WAITING_ADDRESS_TO_SUBMIT_TO_AVENIA, DUPLICATE_TAX_ID, or AVENIA_KYC_SUBMIT_FAILED before the final Pods status is approved.
"APPROVED"
Provider message persisted for support and retry decisions, when available.
"passed"
"passed"
Resolved birth date in YYYY-MM-DD format for BigDataCorp profiles. Null while pending, unavailable, or not applicable to the provider.
"1990-01-01T00:00:00.000Z"
36
When the current BigDataCorp iframe session was created.
"2026-06-15T12:00:00.000Z"
When BigDataCorp completed document, liveness, and identity verification.
"2026-06-15T12:04:00.000Z"
When Pods started the final Avenia submission. Repeated submit requests return the existing provider_pending result while this operation is in progress.
"2026-06-15T12:04:30.000Z"
When the verified BigDataCorp profile was submitted to Avenia.
"2026-06-15T12:05:00.000Z"
When Avenia approved the KYC attempt. For Brazil profiles this coincides with brlaEnabled; for foreign profiles poll usdEnabled after currency unlock.
"2026-06-15T12:06:00.000Z"
Who captured the document. Null for profiles created before evidence sources were recorded.
customer_attested, deframe_managed "customer_attested"
Who ran the liveness check.
customer_attested, deframe_managed "customer_attested"
Type of identity document submitted, when known.
Present only when status is rejected or rejected_retryable. Prefer this over rejectReason and providerResult, which carry raw provider values and vary between providers.
"2026-06-15T12:01:00.000Z"