card:response | Computop Documents

Data Elements

Key

Format

CND

Description

cardholderName

string

Presence depends on merchant configuration. Name of the cardholder as printed on the card. Please contact the Computop Helpdesk, if you need this data in response.

number

string

Presence depends on merchant configuration. If present this element entails either the masked card number or Paygate card token. Please contact the Computop Helpdesk, if you need this data in response.

expiryDate

string

Present if number entails Paygate card token

bin

object

Bank Identification Number including account range if applicable

brand

string

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

product

string

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

source

string

Card funding source (if available).

Values accepted:

DEBIT
CREDIT
DEFERRED DEBIT
PREPAID
CHARGE

type

string

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

country

JSON

Country the card was issued in

issuer

string

Card issuer (if available)

bin

Key

Format

CND

Description

accountBIN

string

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.

accountRangeLow

string

The account number at the low end of the account range

accountRangeHigh

string

The account number at the high end of the account range

Schema

BASEURL= https://www.computop-paygate.com/schemas

1
{
2
	"$schema": "http://json-schema.org/draft-07/schema#",
3
	"$id": "BASEURL/card_response.json",
4
	"title": "card",
5
	"description": "Card Information",
6
	"type": "object",
7
	"properties": {
8
		"cardholderName": {
9
			"type": "string",
10
			"maxLength" : 45,
11
            "minLength" : 2,
12
            "description" : "The name of the cardholder as printed on the card. Alphanumeric special characters, listed in EMV Book 4, “Appendix B”."
13
		},
14
		"number": {
15
			"type" : "string",
16
            "maxLength" : 19,
17
            "minLength" : 12
18
		},
19
		"expiryDate": {
20
			"type": "string",
21
			"description": "YYYYMM",
22
			"minLength": 6,
23
			"maxLength": 6
24
		},
25
		"bin": {
26
			"type": "object",
27
			"properties": {
28
				"accountBin": { "type": "string" },
29
				"accountRangeLow": { "type": "string" },
30
				"accountRangeHigh": { "type": "string" }
31
			},
32
			"additionalProperties": false,
33
			"required": ["accountBin"]
34
		},
35
		"brand": {
36
			"type": "string",
37
			"enum": [
38
				"MasterCard",
39
				"VISA",
40
				"AMEX",
41
				"Diners",
42
				"CBN",
43
				"JCB",
44
				"Dankort",
45
				"Maestro",
46
				"Cartes Bancaires",
47
				"Discover",
48
				"Bancontact",
49
				"Hipercard",
50
				"Elo",
51
				"Aura",
52
				"Carte 4Etoiles",
53
				"AirPlus",
54
				"CUP",
55
				"NARANJA",
56
				"SHOPPING",
57
				"CABAL",
58
				"ARGENCARD",
59
				"CENCOSUD",
60
				"KOOKMIN",
61
				"KEB",
62
				"BC",
63
				"SHINHAN",
64
				"SAMSUNG",
65
				"HYUNDAI",
66
				"LOTTE",
67
				"1euro",
68
				"echequevacances",
69
				"cofidis3xcb",
70
				"facilypay-3x",
71
				"facilypay-3xsansfrais",
72
				"facilypay-4x",
73
				"facilypay-4xsansfrais",
74
				"RuPay"
75
			]
76
		},
77
		"product": {
78
			"type": "string"
79
		},
80
		"source": {
81
			"type": "string",
82
			"enum": ["DEBIT", "CREDIT", "DEFERRED DEBIT", "PREPAID", "CHARGE"]
83
		},
84
		"type": {
85
			"type": "string"
86
		},
87
		"country": {
88
			"type": "object",
89
			"properties": {
90
				"countryName": {
91
					"type": "string",
92
					"description": "Name of the country."
93
				},
94
				"countryA2": {
95
					"type": "string",
96
					"description": "ISO-3166 alpha-2 code."
97
				},
98
				"countryA3": {
99
					"type": "string",
100
					"description": "ISO 3166-1:2013 alpha-3"
101
				},
102
				"countryNumber": {
103
					"type": "string",
104
					"description": "ISO-3166 numeric code."
105
				}
106
			},
107
			"required": ["countryA3"],
108
			"additionalProperties": false
109
		},
110
		"issuer": {
111
			"type": "string"
112
		}
113
	},
114
	"required": ["bin", "brand", "country"],
115
	"additionalProperties": false
116
}

Sample

1
{
2
	"cardholderName": "John Doe",
3
	"bin": {
4
		"accountBin": "492947",
5
		"accountRangeLow": "492947000000",
6
		"accountRangeHigh": "492948387999"
7
	},
8
	"brand": "VISA",
9
	"product": "Business",
10
	"source": "CREDIT",
11
	"type": "CLASSIC",
12
	"country": {
13
		"countryName": "United Kingdom of Great Britain and Northern Ireland",
14
		"countryA2": "GB",
15
		"countryA3": "GBR",
16
		"countryNumber": "826"
17
	},
18
	"issuer": "BARCLAYS BANK PLC"
19
}