---
title: "Create Evaluation"
method: POST
path: "/v1/antifraud/evaluations"
tags: ["WireTransfer"]
---

# Create Evaluation

`POST /v1/antifraud/evaluations`

Receives a new transaction for antifraud analysis.

## Request body

- WireTransferAntiFraud
  - `type` 'WireTransfer', required — Antifraud type
  - `device` TransferDeviceData
    - `ipv4` string — The original ip address v4 from browser. Not required for Payment Antifraud Data with redirection payment. Required if ipv6 is blank
    - `ipv6` string — The original ip address v6 from browser. Not required for Payment Antifraud Data with redirection payment. Required if ipv4 is blank
    - `location` Location
      - `latitude` number, double, required — Device latitude
      - `longitude` number, double, required — Device longitude
    - `merchant_device` string — Id of the device, identified by the merchant by their internal systems
    - `session_id` string — Value generated by javascript/sdk snippet of our device fingerprint solution
  - `store` Store
    - `name` string, required — Store name, must not contain special characters and is limited to 20 characters, including spaces
    - `countryCode` string, required — Two-letter code as described in the ISO 3166 international standard
    - `documentType` 'CPF' | 'CNPJ', required — Type of the document
    - `document` string, required — Document number
    - `integration` 'api-standard' | 'bis2bis' | 'magento-1' | 'magento-2' | 'poolpay' | 'traycorp' | 'shopify' | 'vale-pay' | 'vtex' | 'woocommerce' | 'wbuy' — Integration source
  - `transaction` TransactionData, required
    - `reference_id` string, required — Client transaction identifier
    - `business_id` string — Unique identifier for the store where the transaction takes place.
    - `sequence` string — Sequence number
    - `country_code` string, required — Use the country code of the store site's location where the transaction takes place. This ensures alignment with the store's geographical context. Two-letter code as described in the ISO 3166 international standard
    - `total_amount` Amount, required
      - `currency_code` string, required — Three-letter currency code as described in the ISO 4217 international standard
      - `value` number, required — Amount value
    - `channel` string — Indicates sales channel
  - `account_from` AccountFrom, required
    - `number` string, required — Account number
    - `bank_name` string, required — Account bank name
    - `bank_code` string, required — Account bank code
    - `holder` string, required — Account holder name
    - `currency_code` string — Three-letter currency code as described in the ISO 4217 international standard
    - `type` 'PERSONAL' | 'BUSINESS' — Account type
    - `status` 'OK' | 'TO_VALIDATE' | 'BLOCKED' — Account status
    - `creation_date` string — Account creation date
    - `user_id` string — User identification
  - `account_to` AccountTo, required
    - `number` string, required — Account number
    - `bank_name` string, required — Account bank name
    - `bank_code` string, required — Account bank code
    - `holder` string, required — Account holder name
    - `currency_code` string — Three-letter currency code as described in the ISO 4217 international standard
    - `type` 'PERSONAL' | 'BUSINESS' — Account type
    - `status` 'OK' | 'TO_VALIDATE' | 'BLOCKED' — Account status
    - `creation_date` string — Account creation date
    - `user_id` string — User identification
  - `order_date` string, required — Date order is issued
  - `execution_date` string — Date order is actually executed
  - `instant` boolean — Represents if the transfer will be scheduled or executed now
  - `transfer_type` 'DEPOSIT' | 'WITHDRAW' | 'TRANSFER', required — Transfer type
  - `sla_date` string — The date that the evaluation is expected to be resolved
  - `callback_url` string — A publicly accessible HTTPS endpoint where your application will receive asynchronous notifications about the status of the evaluation.

## Response `200`

Evaluation response

- StandardApiResponse
  - `onboardingId` string, required — Onboarding identification
  - `referenceId` string, required — Client transaction identifier
  - `status` 'PENDING' | 'INPROGRESS' | 'ACTIONREQUIRED' | 'COMPLETED' | 'REJECT' | 'CANCELLED', required — Onboarding status
  - `message` string — Information message
  - `credentials` Credentials
    - `storeCode` string, required — Store code
    - `privateKey` string — Authentication key
    - `orgId` string — Fingerprint key
  - `paymentAccounts` PaymentAccount[]
    - `paymentMethod` 'CARD' — Payment method for the extract
    - `account` string — Payment account number
    - `evaluatesFraud` boolean — Indicates if the account has antifraud

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `500` — Internal Server Error

---

[API](https://skmtc.dev/koin/apis/payments-api.md) · [All operations](https://skmtc.dev/koin/apis/payments-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/koin/payments-api/revisions/6f2c01e43fe2/schema)