Skip to main content
POST
/
test-api
/
card
/
{cardId}
Post test transactions to given card
curl --request POST \
  --url 'https://integration-api-cat2.{{environment}}.ext.{{realm}}.cia.enfuce.com/transaction/test-api/card/{cardId}' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "settlementAmount": 3.14,
  "sicCode": "<string>",
  "transactionAmount": 3.14,
  "transactionCurrency": "EUR",
  "transactionCountry": "FIN",
  "transactionType": "RETAIL",
  "transactionCity": "<string>",
  "transactionDetails": "<string>",
  "transactionDate": "2019-01-28T00:00:00",
  "merchantId": "<string>",
  "authCode": "<string>",
  "sourceNumber": 9999999,
  "retRefCode": 9999999
}
'
{
  "description": "<string>",
  "id": "<string>"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
cardId
string<biginteger>
required

The card id to post test transaction to

Query Parameters

​
auditUser
string
required

The audit user to log the request

Body

application/json

Test transaction payload

​
settlementAmount
number
required

Settlement amount

Example:

3.14

​
sicCode
string
required

Standard Industrial Classification code (4 digit), any number works for testing.

examples: 5542 = Automated Fuel Dispenser, 5411 = Grocery Stores,supermarkets, 5969 = Direct Marketing-Other Dire, 5734 = Computer Software Stores, 5499 = Miscellaneous Food Stores 5812 = Eating Places,Restaurants 5541 = Service Stations 5814 = Fast Food Res. 5999 = Miscellaneous & specialty 7995 = Casino 7273 = Dating Services

​
transactionAmount
number
required

Transaction amount

Example:

3.14

​
transactionCurrency
string
required

A valid ISO 4217 currency code

Example:

"EUR"

​
transactionCountry
string
required

A valid ISO 3166-1 alpha-3 country code, except for QZZ (UNMIK in Kosovo) and ROM for Romania.

Example:

"FIN"

​
transactionType
enum<string>
required
Available options:
RETAIL,
CASH,
ATM,
CREDIT,
UNIQUE,
CHPAYMENT,
CHDEBIT
​
transactionCity
string
required

Transaction city

Maximum string length: 32
​
transactionDetails
string
required

Merchant name

Maximum string length: 255
​
transactionDate
string<date-time>

The local date (and time) when the transaction was made, i.e. the date/time in the time zone of the payment terminal/merchant. Date-time format YYYY-MM-DDThh:mm:ss. Please note that the authorisation and clearing formats used by card schemes do not support conveying the time zone in which the transaction was made and may only include the date with no specific time. Enfuce relays the date and time as received from the card schemes. If not passed it's defaulted to current date-time.

Example:

"2019-01-28T00:00:00"

​
merchantId
string

Merchant Id

Maximum string length: 32
​
authCode
string

Auth code

Maximum string length: 32
​
sourceNumber
string
default:9999999

Source number

Maximum string length: 32
​
retRefCode
string
default:9999999

Ret ref code

Maximum string length: 12

Response

Successful creation of the product

​
description
string

Short description of the result of the action

​
id
string

Will contain the ID of the resource that has been created or updated