card:response
JSON object
card:response
Data elements
| Key | Format | Condition | Description |
| cardholderName | string | C | Presence depends on merchant configuration. Name of the cardholder as printed on the card. Please contact the 1cs Support, if you need this data in response. |
| number | string | C | Presence depends on merchant configuration. If present this element entails either the masked card number or the 1cs Online Payment System card token. Please contact the 1cs Support, if you need this data in response. |
| expiryDate | string | C | Present if number entails the 1cs Online Payment System card token. |
| bin | object | M | Bank Identification Number including account range if applicable. |
| brand | string | M | Card network name (e.g. ‘Visa’, ‘MasterCard’). |
| product | string | C | Card product name (if available) (e.g. ‘Business Premium Debit’). |
| source | string | C | Card funding source (if available). Values accepted: · DEBIT · CREDIT · DEFERRED DEBIT · PREPAID · CHARGE |
| 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.). |
| country | JSON | M | Country the card was issued in. |
| issuer | string | C | Card issuer (if available). |
bin
| Key | Format | Condition | Description |
| 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. |
| accountRangeLow | string | C | The account number at the low end of the account range. |
| accountRangeHigh | string | C | The account number at the high end of the account range. |
Schema
BASEURL= https://www.computop-paygate.com/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",
"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”
}
