Custom

KeyFormatCND

Description

Beschreibung
Custom

ans..1024

O

"Custom"-parameter is added to the request data before encryption and is part of encrypted "Data" in  request. By this they are protected against manipulation by a consumer. 

The Custom-value is added to the  response in plain text and the "|" is replaced by a "&". By this you can put a single value into Custom-parameter and get multiple key-value-pairs back in response for your own purpose. 

Please find a samples here: Custom

Der "Custom"-Parameter wird vor der Verschlüsselung an den Aufruf angehängt und ist Teil des verschlüsselten "Data" im  Aufruf. Dadurch ist der Wert gegen Manipulation geschützt. 

Der Custom-Wert wird dann in Klartext an die -Antwort angehängt und dabei wird "|" durch "&" ersetzt. Dadurch können Sie einen Custom-Wert übergeben und bekommen mehrere Key-Value-Paare zu Ihrer eigenen Verwendung in der Antwort zurück.

Hier finden Sie ein Beispiel: Custom

Sample with multiple custom key-value-pairs / Beispiel mit mehreren spezifischen Key-Value-Paaren:

 action

 request / response

English commentsDeutsche Anmerkungen

 request / Aufruf

Custom=Custom1Key=Custom1Val|Custom2Key=Custom2Val|Custom3Key=Custom3Val&
Amount=<amount>&Currency=<currency>&...

encrypted Request:

Len=123&Data=A1BA...

Custom1Key=Custom1Val|Custom2Key=Custom2Val|Custom3Key=Custom3Val
is considered as one value of parameter "Custom"

and is part of Blowfish-encrypted Data

Custom1Key=Custom1Val|Custom2Key=Custom2Val|Custom3Key=Custom3Val 
wird als ein Wert des Parameters "Custom" gesehen

und wird verschlüsselt in dem Blowfish-verschlüsselten Data geschickt

 response / Antwort
(response=encrypt)

Len=123&Data=9AF8E997....&Custom1Key=Custom1Val&Custom2Key=Custom2Val&Custom3Key=Custom3Val

You receive Len + Data as encrypted response

Custom-value is now part of response in plain text and not encrypted

and "|" has been replaced by "&" so you can receive multiple key-value-pairs.

Sie erhalten nun Len + Data als verschlüsselte Antwort

Der Custom-Wert ist nun unverschlüsselt Teil der Antwort

und "|" wurde ersetzt durch "&", so dass Sie mehrere Key-Value-Paare zurückerhalten.

 response / Antwort
(not encrypted)

mid=YourMerchantId&PayID=a0b2dh1234....&Custom1Key=Custom1Val&Custom2Key=Custom2Val&Custom3Key=Custom3Val

You receive -response unencrypted

Custom-value added to response in plain text 

and "|" has been replaced by "&" so you can receive multiple key-value-pairs.

Sie erhalten die -Antwort unverschlüsselt

Der Custom-Wert ist nun unverschlüsselt in die Antwort eingefügt worden

und "|" wurde ersetzt durch "&", so dass Sie mehrere Key-Value-Paare zurückerhalten.

Sample with multiple custom values / Beispiel mit spezifischen custom Werten:

 action

 request / response

English commentsDeutsche Anmerkungen

 request / Aufruf

Custom=Custom1Val|Custom2Val|Custom3Val&
Amount=<amount>&Currency=<currency>&...

encrypted Request:

Len=123&Data=A1BA...

Custom1Val|Custom2Val|Custom3Val
is considered as one value of parameter "Custom"

and is part of Blowfish-encrypted Data

Custom1Val|Custom2Val|Custom3Val 
wird als ein Wert des Parameters "Custom" gesehen

und wird verschlüsselt in dem Blowfish-verschlüsselten Data geschickt

 response / Antwort
(response=encrypt)

Len=123&Data=9AF8E997....&Custom1Val&Custom2Val&Custom3Val

You receive Len + Data as encrypted response

Custom-value is now part of response in plain text and not encrypted

and "|" has been replaced by "&" so you can receive multiple values.

Sie erhalten nun Len + Data als verschlüsselte Antwort

Der Custom-Wert ist nun unverschlüsselt Teil der Antwort

und "|" wurde ersetzt durch "&", so dass Sie mehrere Werte zurückerhalten.

 response / Antwort
(not encrypted)

mid=YourMerchantId&PayID=a0b2dh1234....&Custom1Val&Custom2Val&Custom3Val

You receive -response unencrypted

Custom-value added to response in plain text 

and "|" has been replaced by "&" so you can receive multiple values.

Sie erhalten die -Antwort unverschlüsselt

Der Custom-Wert ist nun unverschlüsselt in die Antwort eingefügt worden

und "|" wurde ersetzt durch "&", so dass Sie mehrere Werte zurückerhalten.

asd