customerInfo

JSON Objekt

CustomerInfo

Hinweis-icon

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.

Hinweis-icon

„customerInfo“-JSON wird als „billToCustomer“ oder „shipToCustomer“ gesendet. Eine Übersicht der Parameter finden Sie hier:
Kreditkarten – Allgemein per Formular
Kreditkarten – Allgemein per Server-zu-Server

ParameterFormatBedingungBeschreibung
customerNumberans..30OKundennummer
consumerobjectCObjekt zur Beschreibung von Privatkunden. Erforderlich, wenn der Kunde eine Person ist.
businessobjectCObjekt zur Beschreibung von Geschäftskunden. Erforderlich, wenn der Kunde eine juristische Person ist.
phoneobjectCTelefonnummer. 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.
mobilePhoneobjectCMobiltelefonnummer. 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.
emailstringCE-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.
Parameter CustomerInfo

consumer

ParameterFormatBedingungBeschreibung
salutationstringOAnrede Zulässige Werte: · Mr · Mrs · Miss
firstNamestringMVorname des Kunden
lastNamestringMNachname des Kunden
birthDatestringOGeburtsdatum des Kunden im Format JJJJ-MM-TT
Parameter consumer

business

ParameterFormatBedingungBeschreibung
legalNamestringMFirmenname
dbaNamestringOGeschäfte tätigens als
registrationNumberstringOUnternehmens-Registrierungsnummer
Parameter business

Schema

{

    "$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“: 50

                },

                „lastName“: {

                    „type“: „string“,

                    „maxLength“: 50

                },

                „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

}

Beispiel

{

    "consumer": {

        "salutation": "Mr",

        "firstName": "Napoleon",

        „lastName“: „Bonaparte“,

        „birthDate“: „1769-08-15“

    },

    „mobilePhone“: {

        „countryCode“: „33“,

        „subscriberNumber“ : „12345678910“

    },

    „email“: „napoleon.bonaparte@france.com“

}