customerInfo | Computop Documents

Beachten Sie bitte, dass die Daten innerhalb aller JSON-Objekte per UTF-8 kodiert werden und danach zusätzlich mit Base64-codiert sein müssen. Das betrifft insbesondere Sonderzeichen wie z.B. Umlaute.

"customerInfo"-JSON wird als "billToCustomer" oder "shipToCustomer" gesendet. Eine Übersicht der Parameter finden Sie hier:

Datenelemente

Key

Format

CND

Beschreibung

customerNumber

ans..30

Kundennummer

consumer

object

Objekt zur Beschreibung von Privatkunden. Erforderlich, wenn der Kunde eine Person ist.

business

object

Objekt zur Beschreibung von Geschäftskunden. Erforderlich, wenn der Kunde eine juristische Person ist.

phone

object

Telefonnummer. Erforderlich (falls verfügbar), sofern nicht Markt- oder regionale Mandate die Übermittlung dieser Information beschränken.

phone oder mobilePhone oder email werden Pflichtfeld für VISA ab 2024-08-12.

mobilePhone

object

Mobiltelefonnummer. Erforderlich (falls verfügbar), sofern nicht Markt- oder regionale Mandate die Übermittlung dieser Information beschränken.

phone oder mobilePhone oder email werden Pflichtfeld für VISA ab 2024-08-12.

string

E-Mail-Adresse. Erforderlich, sofern nicht Markt- oder regionale Mandate die Übermittlung dieser Information beschränken.

phone oder mobilePhone oder email werden Pflichtfeld für VISA ab 2024-08-12.

consumer

Key

Format

CND

Beschreibung

salutation

string

Anrede

Zulässige Werte:

Mr
Mrs
Miss

firstName

string

Vorname des Kunden

lastName

string

Nachname des Kunden

birthDate

string

Geburtsdatum des Kunden im Format JJJJ-MM-TT

business

Key

Format

CND

Beschreibung

legalName

string

Firmenname

dbaName

string

Geschäfte tätigend als

registrationNumber

string

Unternehmens-Registrierungsnummer

Schema

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

1
{
2
    "$schema": "http://json-schema.org/draft-07/schema#",
3
    "$id": "https://www.computop-paygate.com/schemas/customerInfo.json",
4
    "title": "customerInfo",
5
    "description": "Customer Information",
6
    "type": "object",
7
    "properties": {
8
        "customerNumber": {
9
            "type": "string",
10
            "maxLength": 30
11
        },
12
        "consumer": {
13
            "type": "object",
14
            "additionalProperties": false,
15
            "properties": {
16
                "salutation": {
17
                    "type": "string",
18
                    "enum": [
19
                        "Mr",
20
                        "Mrs",
21
                        "Miss"
22
                    ]
23
                },
24
                "firstName": {
25
                    "type": "string",
26
                    "maxLength": 50
27
                },
28
                "lastName": {
29
                    "type": "string",
30
                    "maxLength": 50
31
                },
32
                "birthDate": {
33
                    "description": "YYYY-MM-DD",
34
                    "type": "string",
35
                    "format": "full-date"
36
                }
37
            },
38
            "required": [
39
                "firstName",
40
                "lastName"
41
            ]
42
        },
43
        "business": {
44
            "type": "object",
45
            "additionalProperties": false,
46
            "properties": {
47
                "legalName": {
48
                    "type": "string",
49
                    "maxLength": 999
50
                },
51
                "dbaName": {
52
                    "description": "Doing business as. Name of the company as usually known to consumers.",
53
                    "type": "string",
54
                    "maxLength": 50
55
                },
56
                "registrationNumber": {
57
                    "type": "string",
58
                    "maxLength": 20
59
                }
60
            },
61
            "required": [
62
                "legalName"
63
            ]
64
        },
65
        "phone": {
66
            "type": "object",
67
            "additionalProperties": false,
68
            "properties": {
69
                "countryCode": {
70
                    "type": "string",
71
                    "minLength": 1,
72
                    "maxLength": 3
73
                },
74
                "subscriberNumber": {
75
                    "type": "string",
76
                    "maxLength": 15
77
                }
78
            },
79
            "required": [
80
                "countryCode",
81
                "subscriberNumber"
82
            ]
83
        },
84
        "mobilePhone": {
85
            "type": "object",
86
            "additionalProperties": false,
87
            "properties": {
88
                "countryCode": {
89
                    "type": "string",
90
                    "minLength": 1,
91
                    "maxLength": 3
92
                },
93
                "subscriberNumber": {
94
                    "type": "string",
95
                    "maxLength": 15
96
                }
97
            },
98
            "required": [
99
                "countryCode",
100
                "subscriberNumber"
101
            ]
102
        },
103
        "email": {
104
            "type": "string",
105
            "maxLength": 256,
106
            "format": "idn-email"
107
        }
108
    },
109
    "oneOf": [
110
        {
111
            "required": [
112
                "consumer"
113
            ]
114
        },
115
        {
116
            "required": [
117
                "business"
118
            ]
119
        }
120
    ],
121
    "additionalProperties": false
122
}

Beispiel

1
{
2
    "consumer": {
3
        "salutation": "Mr",
4
        "firstName": "Napoleon",
5
        "lastName": "Bonaparte",
6
        "birthDate": "1769-08-15"
7
    },
8
    "mobilePhone": {
9
        "countryCode": "33",
10
        "subscriberNumber" : "12345678910"
11
    },
12
    "email": "napoleon.bonaparte@france.com"
13
}