address
JSON Objekt
address
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.
„adress“-JSON wird als „billingAddress“ oder „shippingAddress“ gesendet. Eine Übersicht der Paramenter finden Sie hier:
• Kreditkarten – Allgemein per Formular
• Kreditkarten – Allgemein per Server-zu-Server
| Parameter | Format | Bedingung | Beschreibung |
| city | string(..50) | C | 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 | C | 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 | C | 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) | C | 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) | C | 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) | C | 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) | C | 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
| Parameter | Format | Bedingung | Beschreibung |
| street | string(..50) | M | Straßenname |
| streetNumber | string | C | Hausnummer |
Bitte beachten Sie, dass „street“ und „streetNumber“ zusammen lediglich eine Gesamtlänge von 50 Zeichen erhalten können. Sollten mehr Zeichen verwendet werden, kürzt das System die Werte entsprechend ein.
Schema
BASEURL= https://www.computop-paygate.com/schemas
{
"$schema": "http://json-schema.org/draft-07/schema#",
"$id": "BASEURL/address.json",
"title": "address",
"description": "Address",
"type": "object",
"properties": {
"city": {
"type": "string",
"maxLength": 50
},
"country": {
"type": "object",
"properties": {
"countryName": {
"type": "string",
"description": "Name of the country."
},
"countryA2": {
"type": "string",
"description": "ISO-3166 alpha-2 code."
},
"countryA3": {
"type": "string",
"description": "ISO 3166-1:2013 alpha-3"
},
"countryNumber": {
"type": "string",
"description": "ISO-3166 numeric code."
}
},
"required": ["countryA3"],
"additionalProperties": false
},
"addressLine1": {
"type": "object",
"properties": {
"street": {
"type": "string" ,
"maxLength": 50
},
"streetNumber": {
"type": "string"
}
},
"required": ["street"],
"additionalProperties": false
},
"addressLine2": {
"type": "string",
"maxLength": 50
},
"addressLine3": {
"type": "string",
"maxLength": 50
},
"postalCode": {
"type": "string",
"maxLength": 16
},
"state": {
"type": "string",
"minLength": 2,
"maxLength": 2,
"description": "Alpha-2 code of state or province according to ISO 3166-2:2013 where applicable"
}
},
"required": ["country", "addressLine1", "postalCode"],
"additionalProperties": false
} „title“: „address“,
„description“: „Adresse“,
„type“: „object“,
„properties“: {
„city“: {
„type“: „string“
},
„country“: {
„type“: „object“,
„properties“: {
„countryName“: {
„type“: „string“,
„description“: „Name des Landes.“
},
„countryA2“: {
„type“: „string“,
„description“: „ISO-3166 Alpha-2 Code.“
},
„countryA3“: {
„type“: „string“,
„description“: „ISO 3166-1:2013 Alpha-3“
},
„countryNumber“: {
„type“: „string“,
„description“: „ISO-3166 numerischer Code.“
}
},
„required“: [„countryA3“],
„additionalProperties“: false
},
„addressLine1“: {
„type“: „object“,
„properties“: {
„street“: {
„type“: „string“
},
„streetNumber“: {
„type“: „string“
}
},
„required“: [„street“],
„additionalProperties“: false
},
„addressLine2“: {
„type“: „string“
},
„addressLine3“: {
„type“: „string“
},
„postalCode“: {
„type“: „string“
},
„state“: {
„type“: „string“,
„minLength“: 2,
„maxLength“: 2,
„description“: „Alpha-2 Code des Bundesstaates oder der Provinz gemäß ISO 3166-2:2013, sofern zutreffend“
}
},
„required“: [„country“, „addressLine1“, „postalCode“],
„additionalProperties“: false
}
Beispiel
{
„city“: „New York“,
„country“: {
„countryA3“: „USA“
},
„addressLine1“: {
„street“: „Park Avenue“,
„streetNumber“: „270“
},
„postalCode“: „10017-2070“,
„state“: „NY“
}
