Quarantine Account

Restricts one suspicious account as a precaution: its risk state becomes QUARANTINED and its evaluations get more friction (verifications or review instead of a direct denied). Only allowed from NORMAL: an account that is BLOCKED or RECOVERING cannot be quarantined and returns 409. The only way out of QUARANTINED is a recovery.

Safe to retry: if the account is already in that state, it returns 200 with the existing resource (the same id), without side effects or a new history entry. A retry with different data (for example, another reason) does not change the account or the recorded reason.

Path Params
string
required

The account's user_id: the same details.user_id you send on evaluations. URL-encode it if it contains reserved characters.

Body Params
string
enum
required

Why you restrict the account. ATO_SUSPECTED and ATO_CONFIRMED tell Koin you suspect or confirm an account takeover; NOT_ME records that the member said it was not them; FRAUD_CONFIRMED records a confirmed fraud; INTERNAL_POLICY and OTHER are for reasons of your own program.

Allowed:
string

Free text.

string

The case id in your own system.

Responses

Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json