Sign in

v1

latestOpenAPI 3.0.3Apache License Version 2.02026-07-2631211285.4 KB
Account Take Over Services

Create Evaluation

Receives a new transaction to evaluate Account Take Over request

post/v1/ato/evaluations

Request body

sla_datestring

The date that the evaluation is expected to be resolved

callback_urlstring

A publicly accessible HTTPS endpoint where your application will receive asynchronous notifications about the status of the evaluation.

type'LOGIN' | 'CHANGE_PASSWORD' | 'CHANGE_PROFILE' | 'SIGN_UP' | 'USER_ACTIVATION' | 'GENERAL_CHECKPOINT' | 'ENROLLMENT' | 'ATTEMPT_CHANGE_PASSWORD' | 'ATTEMPT_RESET_PASSWORD' | 'ATTEMPT_ADD_CARD' required

The type of the evaluation

Example request

{
  "device": {
    "ipv4": "70.56.69.13",
    "ipv6": "2001:0db8:85a3:0000:0000:8a2e:0370:7334",
    "location": {
      "latitude": -34.56532789616039,
      "longitude": -58.48945822129388
    },
    "merchant_device": "234c20c3-45de-41bf-b243-87ad5$RTbc3b",
    "session_id": "5b8c20c3-45de-41bf-b243-87ad5d21bc3b"
  },
  "sla_date": "2021-07-23T16:00:00.307062Z",
  "callback_url": "http://domain/service",
  "details": {
    "email": "email@domain.com",
    "user_id": "user12",
    "authentication_type": "PASSWORD",
    "authentication_result": "SUCCESS",
    "document": {
      "nationality": "UY",
      "number": "35645888",
      "type": "DNI"
    }
  }
}

Response

Evaluation response

onboardingIdstring required

Onboarding identification

referenceIdstring required

Client transaction identifier

status'PENDING' | 'INPROGRESS' | 'ACTIONREQUIRED' | 'COMPLETED' | 'REJECT' | 'CANCELLED' required

Onboarding status

messagestring

Information message

Example response

{
  "onboardingId": "31ff2cc8-199e-4c3c-ba2d-4d85b88bd9f2",
  "referenceId": "FGCCCEA53JYSHXX",
  "message": "Test message",
  "credentials": {
    "storeCode": "STORE12",
    "privateKey": "dqwg43yefnjnk5fe",
    "orgId": "s4fes6ytr4"
  },
  "paymentAccounts": [
    {
      "account": "AP12345PI",
      "evaluatesFraud": true
    }
  ]
}