Block Account

Blocks one account: its risk state becomes BLOCKED and all of its sensitive events return denied. Allowed from NORMAL, QUARANTINED, and RECOVERING. You do not need a previous denied: block whenever your own reasons say so. The only way out of BLOCKED 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