address | 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.

"address"-JSON wird als "billingAddress" oder "shippingAddress" gesendet. Eine Übersicht der Parameter finden Sie hier:

Datenelemente

Key

Format

CND

Beschreibung

city

string(..50)

Stadt. Erforderlich, sofern nicht Markt- oder regionale Mandate das Senden dieser Informationen beschränken. Für Versanddetails kann dieses Datenelement nicht verfügbar sein (z.B. digitale Güter).

country

object

Alpha-3 Ländercode gemäß ISO 3166-1:2013. Erforderlich, sofern nicht Markt- oder regionale Mandate das Senden dieser Informationen beschränken. Für Versanddetails kann dieses Datenelement nicht verfügbar sein (z.B. digitale Güter).

addressLine1

object

Erste Zeile der Straßenadresse. Erforderlich, sofern nicht Markt- oder regionale Mandate das Senden dieser Informationen beschränken. Für Versanddetails kann dieses Datenelement nicht verfügbar sein (z.B. digitale Güter).

addressLine2

string(..50)

Zweite Zeile der Straßenadresse (z.B. Apartment, Suite, Etage, Postfach usw.). Erforderlich, sofern nicht Markt- oder regionale Mandate das Senden dieser Informationen beschränken. Für Versanddetails kann dieses Datenelement nicht verfügbar sein (z.B. digitale Güter).

addressLine3

string(..50)

Dritte Zeile der Straßenadresse. Erforderlich, sofern nicht Markt- oder regionale Mandate das Senden dieser Informationen beschränken. Für Versanddetails kann dieses Datenelement nicht verfügbar sein (z.B. digitale Güter).

postalCode

string(..16)

PLZ oder andere Postleitzahl. Erforderlich, sofern nicht Markt- oder regionale Mandate das Senden dieser Informationen beschränken. Für Versanddetails kann dieses Datenelement nicht verfügbar sein (z.B. digitale Güter).

state

string(2)

Alpha-2 Code des Bundesstaates oder der Provinz gemäß ISO 3166-2. Erforderlich, sofern nicht Markt- oder regionale Mandate das Senden dieser Informationen beschränken oder State in diesem Land nicht zutreffend ist. Für Versanddetails kann dieses Datenelement nicht verfügbar sein (z.B. digitale Güter).

Bitte diesen Parameter in der EU nicht benutzen.

addressLine1

Key

Format

CND

Beschreibung

street

string(..50)

Straßenname

streetNumber

string

Hausnummer

Hinweis: Bitte beachten Sie, dass "street" und "streetNumber" zusammen lediglich eine Gesamtlänge von 50 Zeichen enthalten können. Sollten mehr Zeichen verwendet werden, kürzt das System die Werte entsprechend ein.

Schema

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

1
{
2
    "$schema": "http://json-schema.org/draft-07/schema#",
3
    "$id": "BASEURL/address.json",
4
    "title": "address",
5
    "description": "Address",
6
    "type": "object",
7
    "properties": {
8
        "city": {
9
            "type": "string",
10
            "maxLength": 50
11
         },
12
        "country": {
13
            "type": "object",
14
            "properties": {
15
                "countryName": {
16
                    "type": "string",
17
                    "description": "Name of the country."
18
                },
19
                "countryA2": {
20
                    "type": "string",
21
                    "description": "ISO-3166 alpha-2 code."
22
                },
23
                "countryA3": {
24
                    "type": "string",
25
                    "description": "ISO 3166-1:2013 alpha-3"
26
                },
27
                "countryNumber": {
28
                    "type": "string",
29
                    "description": "ISO-3166 numeric code."
30
                }
31
            },
32
            "required": ["countryA3"],
33
            "additionalProperties": false
34
        },
35
        "addressLine1": {
36
            "type": "object",
37
            "properties": {
38
                "street": {
39
                    "type": "string" ,
40
                    "maxLength": 50
41
                },
42
                "streetNumber": {
43
                    "type": "string"
44
                }
45
            },
46
            "required": ["street"],
47
            "additionalProperties": false
48
        },
49
        "addressLine2": {
50
            "type": "string",
51
            "maxLength": 50
52
         },
53
        "addressLine3": {
54
            "type": "string",
55
            "maxLength": 50
56
         },
57
        "postalCode": {
58
            "type": "string",
59
            "maxLength": 16
60
         },
61
        "state": {
62
            "type": "string",
63
            "minLength": 2,
64
            "maxLength": 2,
65
            "description": "Alpha-2 code of state or province according to ISO 3166-2:2013 where applicable"
66
        }
67
    },
68
    "required": ["country", "addressLine1", "postalCode"],
69
    "additionalProperties": false
70
}

Beispiel

1
{
2
    "city": "New York",
3
    "country": {
4
        "countryA3": "USA"
5
    },
6
    "addressLine1": {
7
        "street": "Park Avenue",
8
        "streetNumber": "270"
9
    },
10
    "postalCode": "10017-2070",
11
    "state": "NY"
12
}