Account Status

The Account Status API is used to provide Forter model's additional information: indication of accounts closed by the merchant or accounts that changed in status that reflect agreement or disagreement with Forter's sign up decision (use / ignore the decision). The Account Status API is only intended to provide Forter with additional details and does NOT return a new decision. Rather, the response will always be "NOT_REVIEWED". Please see the Account Status Update API Reference for full details.

This API is only used to provide Forter's model's additional information, the decision returned will always be NOT_REVIEWED. Supplementary parameters like correlationId and accountId are also returned in the API response.

Account Status Integration

Main data points are:

  • Status: updated status (Forter enum format): enumerated values include: ("ACTIVE"; "SUSPENDED"; "CLOSED"; "GUEST"; "PENDING")
  • statusChangeReason: Merchant descriptive reason for closing the account
{
  "accountId": "e520-ba9a-367-60b",
  "eventTime": 1415287568000,
  "status": "SUSPENDED",
  "statusChangeReason": "user violation of coupon abuse policy",
  "connectionInformation": {
    "customerIP": "10.0.0.127",
    "userAgent": "Mozilla/5.0 (Windows NT 6.1; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/47.0.2526.73 Safari/537.36",
    "forterTokenCookie": "2315688945984"
  },
  "type": "BUSINESS",
  "merchantAccountStatus": "open",
  "statusChangeBy": "MERCHANT_ADMIN"
}