customerInfo
JSON object
CustomerInfo
Please note that the data within all JSON objects is encoded using UTF-8 and then must be also Base64 encoded. This applies in particular to special characters such as “Umlaute” and diactrics.
“customerInfo”-JSON is sent as “billToCustomer” or “shipToCustomer”. An overview of parameters can be found here:
• Card processing – common form
• Card processing – common Server-to-Server
Data elements
| Key | Format | Condition | Description |
| consumer | object | C | Object describing private customers. Required if the customer is a person. |
| business | object | C | Object describing business customers. Required if the customer is a legal entity. |
| phone | object | C | Phone number. Required (if available), unless market or regional mandate restricts sending this information. Either phone or mobilePhone or email will become mandatory for VISA on 2024-08-12. |
| mobilePhone | object | C | Mobile phone number. Required (if available) unless market or regional mandate restricts sending this information. Either phone or mobilePhone or email will become mandatory for VISA on 2024-08-12. |
| string | C | Email address. Required unless market or regional mandate restricts sending this information. Either phone or mobilePhone or email will become mandatory for VISA on 2024-08-12. |
consumer
| Key | Format | Condition | Description |
| salutation | string | O | Salutation Values accepted: · Mr · Mrs · Miss |
| firstName | string | M | Customers’ first name. |
| lastName | string | M | Customer’s last name. |
| birthDate | string | O | Customer’s birthdate in format YYYY-MM-DD. |
business
| Key | Format | Condition | Description |
| legalName | string | M | Business legal name. |
| dbaName | string | O | Doing Business As. |
| registrationNumber | string | O | Business registration number. |
Schema
BASEURL= https://www.computop-paygate.com/schemas
{
"$schema": "http://json-schema.org/draft-07/schema#",
"$id": "https://www.computop-paygate.com/schemas/customerInfo.json",
"title": "customerInfo",
“description”: “Kundeninformationen”,
“type”: “object”,
“properties”: {
“consumer”: {
“properties”: {
“salutation”: {
“type”: “string”,
“enum”: [“Mr”, “Mrs”, “Miss”]
},
“firstName”: {
“type”: “string”,
“maxLength”: 30
},
“lastName”: {
“type”: “string”,
“maxLength”: 30
},
“birthDate”: {
“type”: “string”,
“format”: “full-date”,
“description”: “JJJJ-MM-TT”
}
},
“required”: [“firstName”, “lastName”],
“additionalProperties”: false
},
“business”: {
“properties”: {
“legalName”: {
“type”: “string”,
“maxLength”: 50
},
“dbaName”: {
“type”: “string”,
“maxLength”: 50,
“description”: “Geschäfte tätigens als. Unternehmensname, wie er üblicherweise den Kunden bekannt ist.”
},
“registrationNumber”: {
“type”: “string”,
“maxLength”: 20
}
},
“required”: [“legalName”],
“additionalProperties”: false
},
“phone”: {
“type”: “object”,
“properties”: {
“countryCode”: {
“type”: “string”,
“minLength”: 1,
“maxLength”: 3
},
“subscriberNumber”: {
“type”: “string”,
“maxLength”: 15
}
},
“required”: [“countryCode”, “subscriberNumber”],
“additionalProperties”: false
},
“mobilePhone”: {
“type”: “object”,
“properties”: {
“countryCode”: {
“type”: “string”,
“minLength”: 1,
“maxLength”: 3
},
“subscriberNumber”: {
“type”: “string”,
“maxLength”: 15
}
},
“required”: [“countryCode”, “subscriberNumber”],
“additionalProperties”: false
},
“email”: {
“type”: “string”,
“maxLength”: 254,
“format”: “idn-email”
}
},
“oneOf”: [
{“required”: [“consumer”]},
{“required”: [“business”]}
],
“additionalProperties”: false
}
Sample
{
"consumer": {
"salutation": "Mr",
"firstName": "Napoleon",
“lastName”: “Bonaparte”,
“birthDate”: “1769-08-15”
},
“mobilePhone”: {
“countryCode”: “33”,
“subscriberNumber” : “12345678910”
},
“email”: “napoleon.bonaparte@france.com”
}
