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: 

Data Elements


KeyFormatCNDDescription
1customerNumberans..30OCustomer number
2

consumer

object

C

Object describing private customers. Required if the customer is a person. 

3

business

object

C

Object describing business customers. Required if the customer is a legal entity.

4

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. 

5

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. 

6

email

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 



KeyFormatCNDDescription
1

salutation

string

O

Salutation

Values accepted:

  • Mr

  • Mrs

  • Miss

2

firstName

string

M

Customers' first name

3

lastName

string

M

Customer's last name

4

birthDate

string

O

Customer's birthdate in format YYYY-MM-DD


business 



KeyFormatCNDDescription
1

legalName

string

M

Business legal name

2

dbaName

string

O

Doing Business As

3

registrationNumber

string

O

Business registration number


Schema

(info) 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": "Customer Information",
    "type": "object",
    "properties": {
        "customerNumber": {
            "type": "string",
            "maxLength": 30
        },
        "consumer": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
                "salutation": {
                    "type": "string",
                    "enum": [
                        "Mr",
                        "Mrs",
                        "Miss"
                    ]
                },
                "firstName": {
                    "type": "string",
                    "maxLength": 50
                },
                "lastName": {
                    "type": "string",
                    "maxLength": 50
                },
                "birthDate": {
                    "description": "YYYY-MM-DD",
                    "type": "string",
                    "format": "full-date"
                }
            },
            "required": [
                "firstName",
                "lastName"
            ]
        },
        "business": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
                "legalName": {
                    "type": "string",
                    "maxLength": 999
                },
                "dbaName": {
                    "description": "Doing business as. Name of the company as usually known to consumers.",
                    "type": "string",
                    "maxLength": 50
                },
                "registrationNumber": {
                    "type": "string",
                    "maxLength": 20
                }
            },
            "required": [
                "legalName"
            ]
        },
        "phone": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
                "countryCode": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 3
                },
                "subscriberNumber": {
                    "type": "string",
                    "maxLength": 15
                }
            },
            "required": [
                "countryCode",
                "subscriberNumber"
            ]
        },
        "mobilePhone": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
                "countryCode": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 3
                },
                "subscriberNumber": {
                    "type": "string",
                    "maxLength": 15
                }
            },
            "required": [
                "countryCode",
                "subscriberNumber"
            ]
        },
        "email": {
            "type": "string",
            "maxLength": 256,
            "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"
}