Get card

Get card using card number (PAN)

This is a web service designed to lookup an card based on the card number. The payload in the request is encrypted with JWE (JSON Web Encryption), to enable end-to-end encryption from source system to Enfuce.

PCI DSS compliance

Processing payment information (PAN, expiry, CVC2/CVV2) is controlled with strict compliance regulations by the card schemes. There are multiple ways to access the card payment information in Enfuce’s APIs depending on the client solution, and whether the client is a card schema member themselves and therefore responsible for compliance.

The alternative shown here (Get card using card number) relies on that the client is responsible for PCI DSS compliance themselves to the card schema.

POST

card

cardnumber

curl --request POST \
  --url https://integration-api-cat2./%7B{environment}%7D.ext.%7B{realm}%7D.cia.enfuce.com/card/v4/card/cardnumber \
  --header 'Content-Type: application/json' \
  --data '{
  "encryptedData": "<string>"
}'

{
  "additionalValues": [
    {
      "key": "string",
      "value": "string"
    }
  ],
  "cardAddress": {
    "address1": "Kings street 12",
    "address2": "string",
    "address3": "string",
    "address4": "string",
    "city": "Mariehamn",
    "country": "FIN",
    "region": "Åland Islands",
    "zipCode": 22100
  },
  "cardDeliveryType": "CUSTOM_1",
  "digitalLayoutCode": "abc123abc",
  "embossing": {
    "additionalField1": "string",
    "additionalField2": "string",
    "additionalField3": "string",
    "additionalField4": "string",
    "additionalField5": "string",
    "companyName": "Enfuce Financial Services",
    "externalLayoutCode": "BlueCard",
    "firstName": "Monica",
    "lastName": "Liikamaa",
    "manufacturer": "FACTORY_X",
    "physical": true
  },
  "expiration": {
    "month": 1,
    "year": 2019
  },
  "pinAddress": {
    "address1": "Kings street 12",
    "address2": "string",
    "address3": "string",
    "address4": "string",
    "city": "Mariehamn",
    "country": "FIN",
    "region": "Åland Islands",
    "zipCode": 22100
  },
  "pinAttempts": {
    "counter": "integer",
    "max": "integer"
  },
  "pinDeliveryType": "CUSTOM_1",
  "pinStatus": "D",
  "productCode": "MC_CARD_2, VISA_CARD1, VISA_VIRTUAL_3, MC_VIRTUAL_2, VISA_CARD",
  "reason": "string",
  "referenceNumber": "123456789123456",
  "regionAndEcommBlocking": {
    "africa": true,
    "asia": true,
    "ecomm": true,
    "europe": true,
    "home": true,
    "northAmerica": true,
    "oceania": true,
    "southAmerica": true
  },
  "scheduledClosing": {
    "time": "2099-12-31T03:00:00.000Z",
    "type": "TIMEBASED"
  },
  "segment": "SEGMENT_A",
  "usageLimits": [
    {
      "code": "24H",
      "values": [
        {
          "availableAmount": 1200,
          "availableCount": 1200,
          "code": "ATM",
          "count": 5,
          "reset": true,
          "singleAmount": 12.5,
          "sumAmount": 1200,
          "usedAmount": 1200,
          "usedCount": 1200
        }
      ]
    }
  ]
}

{
  "additionalValues": [
    {
      "key": "string",
      "value": "string"
    }
  ],
  "cardAddress": {
    "address1": "Kings street 12",
    "address2": "string",
    "address3": "string",
    "address4": "string",
    "city": "Mariehamn",
    "country": "FIN",
    "region": "Åland Islands",
    "zipCode": 22100
  },
  "cardDeliveryType": "CUSTOM_1",
  "digitalLayoutCode": "abc123abc",
  "embossing": {
    "additionalField1": "string",
    "additionalField2": "string",
    "additionalField3": "string",
    "additionalField4": "string",
    "additionalField5": "string",
    "companyName": "Enfuce Financial Services",
    "externalLayoutCode": "BlueCard",
    "firstName": "Monica",
    "lastName": "Liikamaa",
    "manufacturer": "FACTORY_X",
    "physical": true
  },
  "expiration": {
    "month": 1,
    "year": 2019
  },
  "pinAddress": {
    "address1": "Kings street 12",
    "address2": "string",
    "address3": "string",
    "address4": "string",
    "city": "Mariehamn",
    "country": "FIN",
    "region": "Åland Islands",
    "zipCode": 22100
  },
  "pinAttempts": {
    "counter": "integer",
    "max": "integer"
  },
  "pinDeliveryType": "CUSTOM_1",
  "pinStatus": "D",
  "productCode": "MC_CARD_2, VISA_CARD1, VISA_VIRTUAL_3, MC_VIRTUAL_2, VISA_CARD",
  "reason": "string",
  "referenceNumber": "123456789123456",
  "regionAndEcommBlocking": {
    "africa": true,
    "asia": true,
    "ecomm": true,
    "europe": true,
    "home": true,
    "northAmerica": true,
    "oceania": true,
    "southAmerica": true
  },
  "scheduledClosing": {
    "time": "2099-12-31T03:00:00.000Z",
    "type": "TIMEBASED"
  },
  "segment": "SEGMENT_A",
  "usageLimits": [
    {
      "code": "24H",
      "values": [
        {
          "availableAmount": 1200,
          "availableCount": 1200,
          "code": "ATM",
          "count": 5,
          "reset": true,
          "singleAmount": 12.5,
          "sumAmount": 1200,
          "usedAmount": 1200,
          "usedCount": 1200
        }
      ]
    }
  ]
}

Query Parameters

auditUser

string

required

The audit user to log the request

Body

application/json

Response

200

application/json

Successful lookup of the card

The response is of type object.

Get card Get card using reference number

curl --request POST \
  --url https://integration-api-cat2./%7B{environment}%7D.ext.%7B{realm}%7D.cia.enfuce.com/card/v4/card/cardnumber \
  --header 'Content-Type: application/json' \
  --data '{
  "encryptedData": "<string>"
}'

{
  "additionalValues": [
    {
      "key": "string",
      "value": "string"
    }
  ],
  "cardAddress": {
    "address1": "Kings street 12",
    "address2": "string",
    "address3": "string",
    "address4": "string",
    "city": "Mariehamn",
    "country": "FIN",
    "region": "Åland Islands",
    "zipCode": 22100
  },
  "cardDeliveryType": "CUSTOM_1",
  "digitalLayoutCode": "abc123abc",
  "embossing": {
    "additionalField1": "string",
    "additionalField2": "string",
    "additionalField3": "string",
    "additionalField4": "string",
    "additionalField5": "string",
    "companyName": "Enfuce Financial Services",
    "externalLayoutCode": "BlueCard",
    "firstName": "Monica",
    "lastName": "Liikamaa",
    "manufacturer": "FACTORY_X",
    "physical": true
  },
  "expiration": {
    "month": 1,
    "year": 2019
  },
  "pinAddress": {
    "address1": "Kings street 12",
    "address2": "string",
    "address3": "string",
    "address4": "string",
    "city": "Mariehamn",
    "country": "FIN",
    "region": "Åland Islands",
    "zipCode": 22100
  },
  "pinAttempts": {
    "counter": "integer",
    "max": "integer"
  },
  "pinDeliveryType": "CUSTOM_1",
  "pinStatus": "D",
  "productCode": "MC_CARD_2, VISA_CARD1, VISA_VIRTUAL_3, MC_VIRTUAL_2, VISA_CARD",
  "reason": "string",
  "referenceNumber": "123456789123456",
  "regionAndEcommBlocking": {
    "africa": true,
    "asia": true,
    "ecomm": true,
    "europe": true,
    "home": true,
    "northAmerica": true,
    "oceania": true,
    "southAmerica": true
  },
  "scheduledClosing": {
    "time": "2099-12-31T03:00:00.000Z",
    "type": "TIMEBASED"
  },
  "segment": "SEGMENT_A",
  "usageLimits": [
    {
      "code": "24H",
      "values": [
        {
          "availableAmount": 1200,
          "availableCount": 1200,
          "code": "ATM",
          "count": 5,
          "reset": true,
          "singleAmount": 12.5,
          "sumAmount": 1200,
          "usedAmount": 1200,
          "usedCount": 1200
        }
      ]
    }
  ]
}

Payment API

Account Details

Authorisation Control

Authorisation Forwarding

Card details

Customer

Exchange Rates API

ID

Instalment

Invoice

Notification

PIN

PIN Control

Purchase Details

Repricing

Transaction

Transfer API

Wallet

Test API

Hierarchy API

Spend Control API

Get card using card number (PAN)

PCI DSS compliance

Query Parameters

Body

Response