account

Verify the account

Evaluates the proof and, when everything is satisfied, unlocks the merchant tools. No request body. Send a Bearer JWT or an sk_ API key; NO scope is required. Idempotent: an already-verified account answers 200. On 409 the reason is in error.code and the detail in error.details.missing / error.details.remaining — the same values GET returns. A CPF/CNPJ verifies exactly one account: once bound it can never verify another (verification_tax_number_in_use).

post/api/verification

Request

  • Base URL: https://api.depixapp.com
  • URL: https://api.depixapp.com/api/verification
  • Auth: none required

Response

The account is verified (just now, or already was).

verifiedboolean required

True when the merchant tools are unlocked on this account.

verified_atstring nullable required

When verification completed (RFC 3339 UTC, "YYYY-MM-DDTHH:MM:SS.sssZ"). Null while unverified.

whatsapp_verified0 | 1 required

1 once the account has verified its WhatsApp number, 0 otherwise (raw SQLite boolean). It gates the first deposit — a human account must clear it in the app before verifying. Always 0 for an agent account, which is exempt (it proves a domain instead).

method'round_trip' | 'domain' required

Which proof applies to this account. round_trip: send money from a CPF/CNPJ to the account and withdraw it back to the SAME document. domain: prove control of a registrable domain by DNS TXT (agent accounts — POST /api/agents/verify-domain).

enabledboolean required

False when automatic verification is switched off platform-wide; contact support instead of retrying.

eligibleboolean required

True when every requirement is satisfied and POST /api/verification would promote the account. A promotion still has to land: a suspended account never verifies.

missingstring[] required

Machine-readable list of what is blocking verification — empty when eligible. Branch on these instead of parsing prose.

unlocksstring[] required

What verification unlocks on this account.

Changes

No recorded changes to this operation across all 1 revision of this API.