POST
/
v1
/
evaluate
/
test
curl --request POST \
  --url https://integration-api-cat2./%7B{environment}%7D.ext.%7B{realm}%7D.cia.enfuce.com/spend-control/v1/evaluate/test \
  --header 'Content-Type: application/json' \
  --data '{
  "cardId": "<string>",
  "merchantCategoryCode": "<string>",
  "settlementAmount": {
    "amount": 3.14,
    "currency": "EUR"
  },
  "merchantCountryCode": "FIN",
  "merchantId": "<string>",
  "acquirerId": "<string>",
  "subMerchantId": "<string>",
  "cardholderVerifications": [
    "WALLET"
  ],
  "cardEntryMode": "UNKNOWN",
  "cardholderPresent": true,
  "transactionType": "RETAIL"
}'
{
  "decision": "DECLINE",
  "partialApprovalAmount": {
    "amount": 3.14,
    "currency": "EUR"
  },
  "details": [
    {
      "ruleSetId": "<string>",
      "operator": "ANY",
      "decision": "DECLINE",
      "entityReferences": [
        {
          "id": "<string>",
          "type": "CARD"
        }
      ],
      "partialApprovalAmount": {
        "amount": 3.14,
        "currency": "EUR"
      },
      "ruleEvaluations": [
        {
          "ruleId": "<string>",
          "decision": "DECLINE",
          "partialApprovalAmount": {
            "amount": 3.14,
            "currency": "EUR"
          },
          "settings": {
            "id": "<string>",
            "ruleType": "DECLINE",
            "name": "<string>",
            "filterOperatorType": "ANY",
            "filters": [
              {
                "id": "<string>",
                "type": "MCC",
                "reversed": true
              }
            ]
          }
        }
      ]
    }
  ]
}

Query Parameters

​
auditUser
string
required

The audit user to log the request

Body

application/json
​
cardId
string
required
​
merchantCategoryCode
string
required
​
settlementAmount
object
required

Amount including currency

​
transactionType
enum<string>
required

The transaction type.

Available options:
RETAIL,
ATM,
UNIQUE,
CASH_DISBURSEMENT,
BALANCE_INQUIRY,
P2P_DEBIT,
P2P_CREDIT,
CREDIT,
CASHBACK
​
merchantCountryCode
string

A valid ISO-3166-1 alpha-3 country code.

​
merchantId
string
​
acquirerId
string
​
subMerchantId
string
​
cardholderVerifications
enum<string>[]
Available options:
WALLET,
PIN,
BIO,
THREE_DS
​
cardEntryMode
enum<string>

Describes how the card credentials were captured. Possible values:

  • UNKNOWN - the message from the merchant did not include a distinct method.
  • MANUAL_ENTRY - the card credentials were manually entered by the merchant.
  • MAGNETIC_STRIPE_READ - the magnetic stripe of the card was read by a terminal.
  • CHIP_READ - the EMV chip of the card was read by a terminal
  • CONTACTLESS - contactless transactions, i.e. the card credentials were read with near field communication (NFC) either from chip or digital wallet.
  • ELECTRONIC_COMMERCE - the cardholder entered the card credentials as an e-com merchant.
Available options:
UNKNOWN,
MANUAL_ENTRY,
MAGNETIC_STRIPE_READ,
CHIP_READ,
CONTACTLESS,
ELECTRONIC_COMMERCE
​
cardholderPresent
boolean

Response

200
application/json
Successful rules evaluation
​
decision
enum<string>

Spend control decision

Available options:
DECLINE,
APPROVE_PARTIAL,
APPROVE
​
partialApprovalAmount
object

Amount including currency

​
details
object[]
Overview