Data Elements

Oops, it seems that you need to place a table or a macro generating a table within the Table Filter macro.

The table is being loaded. Please wait for a bit ...


KeyFormatCNDDescriptionBeschreibung
1

cardholderName

string

C

Presence depends on merchant configuration. Name of the cardholder as printed on the card.

Das Vorhandensein hängt von der Händler-Konfiguration ab. Name des Karteninhabers, wie auf der Karte angegeben.
2

number

string

C

Presence depends on merchant configuration. If present this element entails either the masked card number or VR-ePayment Gateway card token.

Das Vorhandensein hängt von der Händler-Konfiguration ab. Falls vorhanden, enthält dieses Element entweder die maskierte Kartennummer oder das -Kartentoken.

3

expiryDate

string

C

Present if number entails VR-ePayment Gateway card token

Vorhanden, falls number das -Kartentoken enthält

4

bin

object

M

Bank Identification Number including account range if applicable

Bankidentifizierungsnummer (BIN) einschließlich untere / obere Grenze, falls vorhanden
5

brand

string

M

Card network name (e.g. 'Visa', 'MasterCard')

Name des Kartennetzwerkes (z.B. 'Visa', 'MasterCard')
6

product

string

C

Card product name (if available) (e.g. 'Business Premium Debit')

Kartenproduktname (falls verfügbar) (z.B. 'Business Premium Debit')
7

source

string

C

Card funding source (if available).

Values accepted:

  • DEBIT

  • CREDIT

  • DEFERRED DEBIT

  • PREPAID

  • CHARGE

Kartenfinanzierungsquelle (falls verfügbar)

Zulässige Werte:

  • DEBIT

  • CREDIT

  • DEFERRED DEBIT

  • PREPAID

  • CHARGE

8

type

string

C

The card type specifies the program, application or card level attached to the card if any (e.g. Classic, Standard, Gold, Business etc.)

Der Kartentyp gibt das zur Karte gehörige Programm, Anwendung oder Karten-Level an, falls vorhanden (z.B. Classic, Standard, Gold, Business usw.)
9

country

JSON

M

Country the card was issued in

Land in dem die Karte ausgestellt ist
10

issuer

string

C

Card issuer (if available)

Kartenaussteller (falls verfügbar)

bin

Oops, it seems that you need to place a table or a macro generating a table within the Table Filter macro.

The table is being loaded. Please wait for a bit ...


KeyFormatCNDDescriptionBeschreibung
1

accountBIN

string

M

The leading six digits of the account number also known as bank identification number (BIN). The BIN consists of 6 to 8 digits – because of PCI DSS rules a maximum of the first 6 digits may be output.

Die ersten sechs Ziffern der Kartennummer, die auch als Bankidentifizierungsnummer bekannt sind (BIN). Die BIN umfasst zwischen 6 und 8 Ziffern – aus Gründen der PCI DSS Regeln dürfen maximal die ersten 6 Ziffern ausgegeben werden.
2

accountRangeLow

string

C

The account number at the low end of the account range

Die untere Grenze der Bankidentifizierungsnummer
3

accountRangeHigh

string

C

The account number at the high end of the account range

Die obere Grenze der Bankidentifizierungsnummer

Schema

(info) BASEURL= https://vr-epayment-gateway.de/schemas

{
	"$schema": "http://json-schema.org/draft-07/schema#",
	"$id": "BASEURL/card_response.json",
	"title": "card",
	"description": "Card Information",
	"type": "object",
	"properties": {
		"cardholderName": {
			"type": "string",
			"maxLength" : 45,
            "minLength" : 2,
            "description" : "The name of the cardholder as printed on the card. Alphanumeric special characters, listed in EMV Book 4, “Appendix B”."
		},
		"number": {
			"type" : "string",
            "maxLength" : 19,
            "minLength" : 12
		},
		"expiryDate": {
			"type": "string",
			"description": "YYYYMM",
			"minLength": 6,
			"maxLength": 6
		},
		"bin": {
			"type": "object",
			"properties": {
				"accountBin": { "type": "string" },
				"accountRangeLow": { "type": "string" },
				"accountRangeHigh": { "type": "string" }
			},
			"additionalProperties": false,
			"required": ["accountBin"]
		},
		"brand": {
			"type": "string",
			"enum": [
				"MasterCard",
				"VISA",
				"AMEX",
				"Diners",
				"CBN",
				"JCB",
				"Dankort",
				"Maestro",
				"Cartes Bancaires",
				"Discover",
				"Bancontact",
				"Hipercard",
				"Elo",
				"Aura",
				"Carte 4Etoiles",
				"AirPlus",
				"CUP",
				"NARANJA",
				"SHOPPING",
				"CABAL",
				"ARGENCARD",
				"CENCOSUD",
				"KOOKMIN",
				"KEB",
				"BC",
				"SHINHAN",
				"SAMSUNG",
				"HYUNDAI",
				"LOTTE",
				"1euro",
				"echequevacances",
				"cofidis3xcb",
				"cofidis4xcb",
				"facilypay-3x",
				"facilypay-3xsansfrais",
				"facilypay-4x",
				"facilypay-4xsansfrais",
				"RuPay"
			]
		},
		"product": {
			"type": "string"
		},
		"source": {
			"type": "string",
			"enum": ["DEBIT", "CREDIT", "DEFERRED DEBIT", "PREPAID", "CHARGE"]
		},
		"type": {
			"type": "string"
		},
		"country": {
			"type": "object",
			"properties": {
				"countryName": {
					"type": "string",
					"description": "Name of the country."
				},
				"countryA2": {
					"type": "string",
					"description": "ISO-3166 alpha-2 code."
				},
				"countryA3": {
					"type": "string",
					"description": "ISO 3166-1:2013 alpha-3"
				},
				"countryNumber": {
					"type": "string",
					"description": "ISO-3166 numeric code."
				}
			},
			"required": ["countryA3"],
			"additionalProperties": false
		},
		"issuer": {
			"type": "string"
		}
	},
	"required": ["bin", "brand", "country"],
	"additionalProperties": false
}

Sample

{
	"cardholderName": "John Doe",
	"bin": {
		"accountBin": "492947",
		"accountRangeLow": "492947000000",
		"accountRangeHigh": "492948387999"
	},
	"brand": "VISA",
	"product": "Business",
	"source": "CREDIT",
	"type": "CLASSIC",
	"country": {
		"countryName": "United Kingdom of Great Britain and Northern Ireland",
		"countryA2": "GB",
		"countryA3": "GBR",
		"countryNumber": "826"
	},
	"issuer": "BARCLAYS BANK PLC"
}