Specific parameters for iCard

Besides the general parameters described above for the credit card connection, iCard requires the following additional parameters. An authorisation with 3-D Secure is possible. The following table describes the encrypted payment request parameters:

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Request_Intro_Additional
PageWithExcerpt	Reuse API

Table Filter

inverse	false
sparkName	Sparkline
hidePane	true
isNew	false
separator	Point (.)
ddSeparators	true
default	Beschreibung
isFirstTimeEnter	false
hideColumns	true
datepattern	dd M yy
id	1656939603431_-1449259253
worklog	365\|5\|8\|y w d h m\|y w d h m
isOR	AND
order	0

Multiexcerpt

MultiExcerptName	request
shouldDisplayInlineCommentsInIncludes	false

Table Transformer

dateFormat	dd M yy
export-word	false
show-source	false
export-csv	false
id	1624613779825_109915252
transpose	false
worklog	365\|5\|8\|y w d h m\|y w d h m
separator	.
export-pdf	false
sql	SELECT * FROM T*

Key

Format

CND

Description

Beschreibung

RefNr

ns..30

O

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	RefNr_Ctsf_Text
PageWithExcerpt	Reuse API

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	RefNr_Ascii
PageWithExcerpt	Reuse API

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	RefNr_Ctsf_Text
PageWithExcerpt	DE:Reuse API

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	RefNr_Ascii
PageWithExcerpt	DE:Reuse API

CustomerID

ans..255

O

Customer access data on the merchant’s checkout page (email, ID, telephone number or name)

Zugangsdaten des Kunden auf der Checkout-Seite des Händlers (E-Mail, ID, Telefonnummer oder Namen)

OrderDesc

ans..768

O

Description of purchased goods, unit prices etc.

Beschreibung der gekauften Waren, Einzelpreise etc.

RTF

a1

O

for repeat payments (subscriptions): I = Initial payment of a new subscription
R = Routine payment (Recurring)

bei wiederkehrenden Zahlungen (Abos): I = Initialzahlung eines neuen Abos, R = Wiederkehrende Zahlung (Recurring)

Additional parameters for credit card payments

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Response_Intro_Additional
PageWithExcerpt	Reuse API

Table Filter

inverse	false
sparkName	Sparkline
hidePane	true
isNew	false
separator	Point (.)
ddSeparators	true
default	Beschreibung
isFirstTimeEnter	false
hideColumns	true
datepattern	dd M yy
id	1656939629128_1503292857
worklog	365\|5\|8\|y w d h m\|y w d h m
isOR	AND
order	0

Multiexcerpt

MultiExcerptName	response
shouldDisplayInlineCommentsInIncludes	false

Table Transformer

dateFormat	dd M yy
export-word	false
show-source	false
export-csv	false
id	1624613790501_902522505
transpose	false
worklog	365\|5\|8\|y w d h m\|y w d h m
separator	.
export-pdf	false
sql	SELECT * FROM T*

Key

Format

CND

Description

Beschreibung

RefNr

ns..30

O

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	RefNr_Ctsf_Text
PageWithExcerpt	Reuse API

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	RefNr_Ascii
PageWithExcerpt	Reuse API

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	RefNr_Ctsf_Text
PageWithExcerpt	DE:Reuse API

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	RefNr_Ascii
PageWithExcerpt	DE:Reuse API

ErrorText

ans..

OC

Error text from iCard, if agreed with

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Helpdesk-Name
PageWithExcerpt	Wording

. Is returned only if ResponseExtended=Yes is configured for that merchant.

Fehlertext von iCard, wenn mit

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	Helpdesk-Name
PageWithExcerpt	DE:Wording

abgesprochen. Wird nur zurückgegeben, wenn der Händler ResponseExtended=Yes konfiguriert hat.

CodeExt

n..3

OC

Error code from iCard, if agreed with

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Helpdesk-Name
PageWithExcerpt	Wording

. Is returned only if ResponseExtended=Yes is configured for that merchant.

Fehlercode von iCard, wenn mit

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	Helpdesk-Name
PageWithExcerpt	DE:Wording

abgesprochen. Wird nur zurückgegeben, wenn der Händler ResponseExtended=Yes konfiguriert hat.

ApprovalCode

ans..6

O

ApprovalCode or Authorisation code returned by card issuer

vom Kartenaussteller zurückgegebener ApprovalCode oder Autorisierungscode

Additional response parameters for credit card payments

Include Page

	Card processing - common form
	Card processing - common form

Include Page

	Card processing - common Server-to-Server
	Card processing - common Server-to-Server

Capture / Credit / Reversal

Capture

Captures are possible via a Server-to-Server connection. To perform a capture via a Server-to-Server connection please use the following URL:

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	BaseURL
PageWithExcerpt	Wording

capture.aspx

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Request_Intro
PageWithExcerpt	Reuse API

Table Filter

inverse	false
sparkName	Sparkline
hidePane	true
isNew	false
separator	Point (.)
ddSeparators	true
default	Beschreibung
isFirstTimeEnter	false
hideColumns	true
datepattern	dd M yy
id	1656939656461_1154250281
worklog	365\|5\|8\|y w d h m\|y w d h m
isOR	AND
order	0

Multiexcerpt

MultiExcerptName	capture_request

Table Transformer

dateFormat	dd M yy
export-word	false
show-source	false
export-csv	false
id	1634194288197_-1454294250
transpose	false
worklog	365\|5\|8\|y w d h m\|y w d h m
separator	.
export-pdf	false
sql	SELECT * FROM T*

Table Excerpt Include

static	true
name	MerchantID
page	MerchantID
type	page

Table Excerpt Include

static	true
name	PayID
page	PayID
type	page

Table Excerpt Include

static	true
name	TransID
page	TransID
type	page

Key

Format

CND

Description

Beschreibung

RefNr

ns..30

O

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	RefNr_Ctsf_Text
PageWithExcerpt	Reuse API

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	RefNr_Ascii
PageWithExcerpt	Reuse API

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	RefNr_Ctsf_Text
PageWithExcerpt	DE:Reuse API

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	RefNr_Ascii
PageWithExcerpt	DE:Reuse API

Table Excerpt Include

static	true
name	Amount
page	Amount
type	page

Table Excerpt Include

static	true
name	Currency
page	Currency
type	page

Table Excerpt Include

static	true
name	MAC
page	MAC
type	page

Table Excerpt Include

static	true
name	ReqId-ans..32
page	ReqId
type	page

Key	Format	CND	Description	Beschreibung
FinishAuth	a1	C	Only with ETM: Transmit value <Y> in order to stop the renewal of guaranteed authorisations and rest amounts after partial captures. Please use this parameter only if you are using the additional function ETM (Extended Transactions Managament).	Nur bei ETM: Übergeben Sie den Wert <Y>, um bei Teilbuchungen die Autorisierungserneuerung oder die Reservierung des Restbetrages zu stoppen. Bitte nutzen Sie den Parameter nur, wenn Sie die Zusatzfunktion ETM (Erweitertes Transaktions-Managament) nutzen.
Textfeld1	ans..30	O	Card holder information: Name	Karteninhaber-Information: Name
Textfeld2	ans..30	O	Card holder information: City	Karteninhaber-Information: Ort

Parameters for captures of credit card payments

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Response_Intro
PageWithExcerpt	Reuse API

Table Filter

inverse	false
sparkName	Sparkline
hidePane	true
isNew	false
separator	Point (.)
ddSeparators	true
default	Beschreibung
isFirstTimeEnter	false
hideColumns	true
datepattern	dd M yy
id	1656940126733_-2037647943
worklog	365\|5\|8\|y w d h m\|y w d h m
isOR	AND
order	0

Multiexcerpt

MultiExcerptName	capture_response

Table Transformer

dateFormat	dd M yy
export-word	false
show-source	false
export-csv	false
id	1634194429173_560522753
transpose	false
worklog	365\|5\|8\|y w d h m\|y w d h m
separator	.
export-pdf	false
sql	SELECT * FROM T*

Table Excerpt Include

static	true
name	MID
page	mid
type	page

Table Excerpt Include

static	true
name	PayID
page	PayID
type	page

Table Excerpt Include

static	true
name	XID
page	XID
type	page

Table Excerpt Include

static	true
name	TransID
page	TransID
type	page

Key

Format

CND

Description

Beschreibung

RefNr

ns..30

O

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	RefNr_Ctsf_Text
PageWithExcerpt	Reuse API

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	RefNr_Ascii
PageWithExcerpt	Reuse API

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	RefNr_Ctsf_Text
PageWithExcerpt	DE:Reuse API

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	RefNr_Ascii
PageWithExcerpt	DE:Reuse API

Table Excerpt Include

static	true
name	Status_OK_FAILED
page	Status
type	page

Table Excerpt Include

static	true
name	Description
page	Description
type	page

Table Excerpt Include

static	true
name	Code
page	Code
type	page

Response parameters for captures of credit card payments

Capture (Multiple Partial)

Captures are possible via a Server-to-Server connection. In case of multiple partial captures, an extra JSON object needs to be sent. To perform a capture via a Server-to-Server connection please use the following URL:

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	BaseURL
PageWithExcerpt	Wording

capture.aspx

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Request_Intro
PageWithExcerpt	Reuse API

Table Filter

inverse	false
sparkName	Sparkline
hidePane	true
isNew	false
separator	Point (.)
ddSeparators	true
default	Beschreibung
isFirstTimeEnter	false
hideColumns	true
datepattern	dd M yy
id	1656940303149_1025433751
worklog	365\|5\|8\|y w d h m\|y w d h m
isOR	AND
order	0

Multiexcerpt

MultiExcerptName	capture_multiplepartial_request

Table Transformer

dateFormat	dd M yy
export-word	false
show-source	false
export-csv	false
id	1634207465021_-1102712405
transpose	false
worklog	365\|5\|8\|y w d h m\|y w d h m
separator	.
export-pdf	false
sql	SELECT * FROM T*

Table Excerpt Include

static	true
name	MerchantID
page	MerchantID
type	page

Table Excerpt Include

static	true
name	PayID
page	PayID
type	page

Table Excerpt Include

static	true
name	TransID
page	TransID
type	page

Key

Format

CND

Description

Beschreibung

RefNr

ns..30

O

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	RefNr_Ctsf_Text
PageWithExcerpt	Reuse API

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	RefNr_Ascii
PageWithExcerpt	Reuse API

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	RefNr_Ctsf_Text
PageWithExcerpt	DE:Reuse API

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	RefNr_Ascii
PageWithExcerpt	DE:Reuse API

Table Excerpt Include

static	true
name	Amount
page	Amount
type	page

Table Excerpt Include

static	true
name	Currency
page	Currency
type	page

Table Excerpt Include

static	true
name	MAC
page	MAC
type	page

Table Excerpt Include

static	true
name	ReqId-ans..32
page	ReqId
type	page

Key

Format

CND

Description

Beschreibung

ApprovalCode

ans..6

M

taken from the original authorization

von der originalen Autorisierung

JSON object

JSON-Objekt

captureinfo

ans..1024

M

New parameter for multiple partial captures. This parameter must be created in JSON format.

The individual parameters in JSON format are following:

curIdx (M) - format: n..2 – Unique ID for this particular capture - Needed for a refund of this exact capture,

total (M) - format: n..2 – Multiple Capture Sequence Count – maximum number of captures per authorisation - possible values 1-99

final (M) - format: an..3 – Final capture flag

"no" – Not last capture

"yes" – Last capture – After sending a "yes", no more captures are possible!

This is an example of the JSON that can be used. Important: captureinfo=Base64-JSON (base64 encoded)

Code Block

language	json
linenumbers	true

{
    "$schema": "http://json-schema.org/draft-07/schema#",
    "$id": "https://www.computop-paygate.com/schemas/captureInfo.json",
    "title": "captureInfo",
    "examples": [
        // usage: capture=manual|auto|<nn>|Base64-JSON
        {
            "auto": "yes"
        },
        {
            "manual": {
                "final": "no"
            }
        },
        {
            "manual": {
                "final": "no",
                "total": 3
            }
        },
        {
            "manual": {
                "final": "yes"
            }
        },
        {
            "manual": {
                "final": "yes",
                "curIdx": 2,
                "total": 3
            }
        },
        {
            "manual": {
                "final": "yes",
                "total": 3
            }
        },
        {
            "delayed": {
                "hours": 30
            }
        }
    ],
    "description": "captureInfo",
    "properties": {
        "auto": {
            "type": "string",
            "enum": [
                "yes"
            ],
            "additionalProperties": false
        },
        "manual": {
            "type": "object",
            "properties": {
                "final": {
                    "type": "string",
                    "enum": [
                        "yes",
                        "no"
                    ]
                },
                "total": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 99
                },
                "curIdx": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 99
                }
            },
            "required": [
                "final"
            ],
            "additionalProperties": false
        },
        "delayed": {
            "type": "object",
            "properties": {
                "hours": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 99
                }
            },
            "required": [
                "hours"
            ],
            "additionalProperties": false
        }
    },
    "oneOf": [
        {
            "required": [
                "manual"
            ]
        },
        {
            "required": [
                "delayed"
            ]
        },
        {
            "required": [
                "auto"
            ]
        }
    ],
    "additionalProperties": false
}

Neuer Parameter für mehrfache Teilbuchungen. Dieser Parameter muss im JSON-Format angelegt werden.

Die einzelnen Parameter im JSON-Format sind folgende:

curIdx (M) - Format: n..2 – Eindeutige ID für diese bestimmte Buchung – Für eine Gutschrift zu genau dieser Buchung nötig,

total (M) - Format: n..2 – Mehrfachbuchung-Sequenzzähler – maximale Anzahl Buchungen pro Autorisierung – mögliche Werte 1-99

final (M) - Format: an..3 – Flag für letzte Buchung

"no" – Nicht die letzte Buchung

"yes" – Letzte Buchung – Nach dem Senden von "yes" sind kein weiteren Buchungen mehr möglich!

Dieses JSON-Beispiel kann verwendet werden. Wichtig: captureinfo=Base64-JSON (base64-codiert)

Code Block

language	json
linenumbers	true

{
    "$schema": "http://json-schema.org/draft-07/schema#",
    "$id": "https://www.computop-paygate.com/schemas/captureInfo.json",
    "title": "captureInfo",
    "examples": [
        // usage: capture=manual|auto|<nn>|Base64-JSON
        {
            "auto": "yes"
        },
        {
            "manual": {
                "final": "no"
            }
        },
        {
            "manual": {
                "final": "no",
                "total": 3
            }
        },
        {
            "manual": {
                "final": "yes"
            }
        },
        {
            "manual": {
                "final": "yes",
                "curIdx": 2,
                "total": 3
            }
        },
        {
            "manual": {
                "final": "yes",
                "total": 3
            }
        },
        {
            "delayed": {
                "hours": 30
            }
        }
    ],
    "description": "captureInfo",
    "properties": {
        "auto": {
            "type": "string",
            "enum": [
                "yes"
            ],
            "additionalProperties": false
        },
        "manual": {
            "type": "object",
            "properties": {
                "final": {
                    "type": "string",
                    "enum": [
                        "yes",
                        "no"
                    ]
                },
                "total": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 99
                },
                "curIdx": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 99
                }
            },
            "required": [
                "final"
            ],
            "additionalProperties": false
        },
        "delayed": {
            "type": "object",
            "properties": {
                "hours": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 99
                }
            },
            "required": [
                "hours"
            ],
            "additionalProperties": false
        }
    },
    "oneOf": [
        {
            "required": [
                "manual"
            ]
        },
        {
            "required": [
                "delayed"
            ]
        },
        {
            "required": [
                "auto"
            ]
        }
    ],
    "additionalProperties": false
}

Parameters for multiple partial captures of credit card payments

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Response_Intro
PageWithExcerpt	Reuse API

Table Filter

inverse	false
sparkName	Sparkline
hidePane	true
isNew	false
separator	Point (.)
ddSeparators	true
default	Beschreibung
isFirstTimeEnter	false
hideColumns	true
datepattern	dd M yy
id	1656940355987_-1070564640
worklog	365\|5\|8\|y w d h m\|y w d h m
isOR	AND
order	0

Multiexcerpt

MultiExcerptName	capture_multiplepartial_response

Table Transformer

dateFormat	dd M yy
export-word	false
show-source	false
export-csv	false
id	1634207493997_1294035609
transpose	false
worklog	365\|5\|8\|y w d h m\|y w d h m
separator	.
export-pdf	false
sql	SELECT * FROM T*

Table Excerpt Include

static	true
name	MID
page	mid
type	page

Table Excerpt Include

static	true
name	PayID
page	PayID
type	page

Table Excerpt Include

static	true
name	XID
page	XID
type	page

Table Excerpt Include

static	true
name	TransID
page	TransID
type	page

Table Excerpt Include

static	true
name	Status_OK_FAILED
page	Status
type	page

Table Excerpt Include

static	true
name	Description
page	Description
type	page

Table Excerpt Include

static	true
name	Code
page	Code
type	page

Key

Format

CND

Description

Beschreibung

RefNr

ns..30

O

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	RefNr_Ctsf_Text
PageWithExcerpt	Reuse API

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	RefNr_Ascii
PageWithExcerpt	Reuse API

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	RefNr_Ctsf_Text
PageWithExcerpt	DE:Reuse API

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	RefNr_Ascii
PageWithExcerpt	DE:Reuse API

original_trn

n20

M

TRN of the original transaction

TRN der originalen Transaktion

ApprovalCode

ans..6

M

taken from the original authorization

von der originalen Autorisierung

Response parameters for multiple partial captures of credit card payments

Credit with reference

Credits (refunds) are possible via a Server-to-Server connection.

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Platform-Kurz
PageWithExcerpt	Wording

permits credits which relate to a capture previously activated by

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Platform-Kurz
PageWithExcerpt	Wording

and allows merchants to carry out credits without a reference transaction. This section describes the processing of credits with reference transactions. If you refer to a capture for a Credit, the amount of the Credit is limited to the amount of the previous capture.

To carry out a credit with a reference transaction, please use the following URL:

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	BaseURL
PageWithExcerpt	Wording

credit.aspx

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Request_Intro
PageWithExcerpt	Reuse API

Table Filter

inverse	false
sparkName	Sparkline
hidePane	true
isNew	false
separator	Point (.)
ddSeparators	true
default	Beschreibung
isFirstTimeEnter	false
hideColumns	true
datepattern	dd M yy
id	1656940411012_1981203210
worklog	365\|5\|8\|y w d h m\|y w d h m
isOR	AND
order	0

Multiexcerpt

MultiExcerptName	credit_request

Table Transformer

dateFormat	dd M yy
export-word	false
show-source	false
export-csv	false
id	1634194516403_548431602
transpose	false
worklog	365\|5\|8\|y w d h m\|y w d h m
separator	.
export-pdf	false
sql	SELECT * FROM T*

Table Excerpt Include

static	true
name	MerchantID
page	MerchantID
type	page

Table Excerpt Include

static	true
name	PayID
page	PayID
type	page

Table Excerpt Include

static	true
name	TransID
page	TransID
type	page

Table Excerpt Include

static	true
name	Amount
page	Amount
type	page

Table Excerpt Include

static	true
name	Currency
page	Currency
type	page

Table Excerpt Include

static	true
name	MAC
page	MAC
type	page

Key	Format	CND	Description	Beschreibung
OrderDesc	ans..768	O	Description of refunded goods, unit prices, merchant’s comment etc. (not with Clearhaus)	Beschreibung der gutgeschriebenen Artikel, Einzelpreise, Händlerkommentar etc. (Nicht bei Clearhaus)

Table Excerpt Include

static	true
name	ReqId-ans..32
page	ReqId
type	page

Key	Format	CND	Description	Beschreibung
Textfeld1	ans..30	O	Card holder information: Name	Karteninhaber-Information: Name
Textfeld2	ans..30	O	Card holder information: City	Karteninhaber-Information: Ort

Parameters for credits of credit card payments

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Response_Intro
PageWithExcerpt	Reuse API

Table Filter

inverse	false
sparkName	Sparkline
hidePane	true
isNew	false
separator	Point (.)
ddSeparators	true
default	Beschreibung
isFirstTimeEnter	false
hideColumns	true
datepattern	dd M yy
id	1656940530418_-2003935258
worklog	365\|5\|8\|y w d h m\|y w d h m
isOR	AND
order	0

Multiexcerpt

MultiExcerptName	credit_response

Table Transformer

dateFormat	dd M yy
export-word	false
show-source	false
export-csv	false
id	1634194642769_-1274601573
transpose	false
worklog	365\|5\|8\|y w d h m\|y w d h m
separator	.
export-pdf	false
sql	SELECT * FROM T*

Table Excerpt Include

static	true
name	MID
page	mid
type	page

Table Excerpt Include

static	true
name	PayID
page	PayID
type	page

Table Excerpt Include

static	true
name	XID
page	XID
type	page

Table Excerpt Include

static	true
name	TransID
page	TransID
type	page

Table Excerpt Include

static	true
name	Status_OK_FAILED
page	Status
type	page

Table Excerpt Include

static	true
name	Description
page	Description
type	page

Table Excerpt Include

static	true
name	Code
page	Code
type	page

Response parameters for credits of credit card payments

Credit with reference (for multiple captures)

Credits (refunds) are possible via a Server-to-Server connection.

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Platform-Kurz
PageWithExcerpt	Wording

permits credits which relate to a capture previously activated by

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Platform-Kurz
PageWithExcerpt	Wording

and allows merchants to carry out credits without a reference transaction. This section describes the processing of credits with reference transactions. This action will credit a specific partial capture , using a specific identifier (XID), the same received when performing the capture.

To carry out a credit with a reference transaction done using the multiple partial capture feature, please use the following URL:

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	BaseURL
PageWithExcerpt	Wording

credit.aspx

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Request_Intro
PageWithExcerpt	Reuse API

Table Filter

inverse	false
sparkName	Sparkline
hidePane	true
isNew	false
separator	Point (.)
ddSeparators	true
default	Beschreibung
isFirstTimeEnter	false
hideColumns	true
datepattern	dd M yy
id	1656941152474_-1698038538
worklog	365\|5\|8\|y w d h m\|y w d h m
isOR	AND
order	0

Multiexcerpt

MultiExcerptName	credit_multiplepartial_request

Table Transformer

dateFormat	dd M yy
export-word	false
show-source	false
export-csv	false
id	1634207568757_5422223
transpose	false
worklog	365\|5\|8\|y w d h m\|y w d h m
separator	.
export-pdf	false
sql	SELECT * FROM T*

Table Excerpt Include

static	true
name	MerchantID
page	MerchantID
type	page

Table Excerpt Include

static	true
name	PayID
page	PayID
type	page

Table Excerpt Include

static	true
name	TransID
page	TransID
type	page

Table Excerpt Include

static	true
name	Amount
page	Amount
type	page

Table Excerpt Include

static	true
name	Currency
page	Currency
type	page

Table Excerpt Include

static	true
name	MAC
page	MAC
type	page

Key

Format

CND

Description

Beschreibung

RefNr

ns..30

O

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	RefNr_Ctsf_Text
PageWithExcerpt	Reuse API

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	RefNr_Ascii
PageWithExcerpt	Reuse API

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	RefNr_Ctsf_Text
PageWithExcerpt	DE:Reuse API

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	RefNr_Ascii
PageWithExcerpt	DE:Reuse API

ApprovalCode

ans..6

M

taken from the original authorization

von der originalen Autorisierung

XID

ans..32

M

XID of the capture to be credited, taken from the capture response

XID von der Teilbuchung, die gutgeschrieben werden soll. Diese XID haben Sie bei der Buchung/Capture erhalten.

OrderDesc

ans..768

O

Description of refunded goods, unit prices, merchant’s comment etc.

Beschreibung der gutgeschriebenen Waren, Einzelpreise, Händlerkommentar usw.

Table Excerpt Include

static	true
name	ReqId-ans..32
page	ReqId
type	page

Key	Format	CND	Description	Beschreibung
			JSON object	JSON-Objekt
captureinfo	ans..1024	M	Parameter needed to refund a specific MPC capture. This parameter must be created in JSON format. curIdx (M) – format: n..2 – Unique ID for this particular capture	Nötiger Parameter für die Gutschrift eine bestimmten Teilbuchung. Dieser Parameter muss im JSON-Format angelegt werden. curIdx (M) - Format: n..2 – Eindeutige ID für diese bestimmte Buchung

Parameters for credits of multiple captures of credit card payments

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Response_Intro
PageWithExcerpt	Reuse API

Table Filter

inverse	false
sparkName	Sparkline
hidePane	true
isNew	false
separator	Point (.)
ddSeparators	true
default	Beschreibung
isFirstTimeEnter	false
hideColumns	true
datepattern	dd M yy
id	1656941206584_-1530226580
worklog	365\|5\|8\|y w d h m\|y w d h m
isOR	AND
order	0

Multiexcerpt

MultiExcerptName	credit_multiplepartial_response

Table Transformer

dateFormat	dd M yy
export-word	false
show-source	false
export-csv	false
id	1634207596034_-1483553183
transpose	false
worklog	365\|5\|8\|y w d h m\|y w d h m
separator	.
export-pdf	false
sql	SELECT * FROM T*

Table Excerpt Include

static	true
name	MID
page	mid
type	page

Table Excerpt Include

static	true
name	PayID
page	PayID
type	page

Table Excerpt Include

static	true
name	XID
page	XID
type	page

Table Excerpt Include

static	true
name	TransID
page	TransID
type	page

Table Excerpt Include

static	true
name	Status_OK_FAILED
page	Status
type	page

Table Excerpt Include

static	true
name	Description
page	Description
type	page

Table Excerpt Include

static	true
name	Code
page	Code
type	page

Key

Format

CND

Description

Beschreibung

RefNr

ns..30

O

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	RefNr_Ctsf_Text
PageWithExcerpt	Reuse API

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	RefNr_Ascii
PageWithExcerpt	Reuse API

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	RefNr_Ctsf_Text
PageWithExcerpt	DE:Reuse API

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	RefNr_Ascii
PageWithExcerpt	DE:Reuse API

ApprovalCode

ans..6

M

taken from the original authorization

von der originalen Autorisierung

Response parameters for credits of mutiple captures of credit card payments

Credit without reference

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Platform-Kurz
PageWithExcerpt	Wording

can carry out Credits which do not relate to a previous capture. In this case the credit must be transferred to

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Platform-Kurz
PageWithExcerpt	Wording

as a completely new payment transaction. Please contact the

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Helpdesk-Name
PageWithExcerpt	Wording

for help in using the described additional functions.

Notice: Please note that credits without reference to a previous capture generate higher costs with your Acquiring Bank. If you are frequently unable to make reference to the capture you should agree this with your Acquiring Bank.

To carry out a Credit without a reference transaction via a Server-to-Server connection, please use the following URL:

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	BaseURL
PageWithExcerpt	Wording

creditex.aspx

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Request_Intro
PageWithExcerpt	Reuse API

Table Filter

inverse	false
sparkName	Sparkline
hidePane	true
isNew	false
separator	Point (.)
ddSeparators	true
default	Beschreibung
isFirstTimeEnter	false
hideColumns	true
datepattern	dd M yy
id	1656941248969_-1967205724
worklog	365\|5\|8\|y w d h m\|y w d h m
isOR	AND
order	0

Multiexcerpt

MultiExcerptName	creditex_request

Table Transformer

dateFormat	dd M yy
export-word	false
show-source	false
export-csv	false
id	1634194717341_1905059295
transpose	false
worklog	365\|5\|8\|y w d h m\|y w d h m
separator	.
export-pdf	false
sql	SELECT * FROM T*

Table Excerpt Include

static	true
name	MerchantID
page	MerchantID
type	page

Table Excerpt Include

static	true
name	TransID
page	TransID
type	page

Table Excerpt Include

static	true
name	Amount
page	Amount
type	page

Table Excerpt Include

static	true
name	Currency
page	Currency
type	page

Table Excerpt Include

static	true
name	MAC
page	MAC
type	page

Key	Format	CND	Description	Beschreibung
OrderDesc	ans..768	O	Description of refunded goods, unit prices, merchant’s comment etc.	Beschreibung der gutgeschriebenen Artikel, Einzelpreise, Händlerkommentar etc.

Table Excerpt Include

static	true
name	ReqId-ans..32
page	ReqId
type	page

Key	Format	CND	Description	Beschreibung
CCNr	n..16	M	Credit card number at least 12-digit, numerical without spaces	Kreditkartennummer mind. 12stellig numerisch ohne Leerzeichen
CCCVC	n..4	O	Card verification number: The last 3 digits on the signature strip of the credit card. 4 numbers in the case of American Express.	Kartenprüfnummer: Die letzten 3 Ziffern auf dem Unterschriftsfeld der Kreditkarte. Bei American Express 4 Ziffern.
CCExpiry	n6	M	Expiry date of the credit card in the format YYYYMM, e.g. 201707.	Ablaufdatum der Kreditkarte im Format YYYYMM, z.B. 201707
CCBrand	a..22	M	Credit card brand. Please note the spelling! According to table of credit card brands!	Kreditkartenmarke. Bitte beachten Sie die Schreibweise gemäß Tabelle der Kreditkartenmarken!
OrderDesc	ans..768	MC	Description of refunded goods, unit prices, merchant’s comment etc.	Beschreibung der gutgeschriebenen Artikel, Einzelpreise, Händlerkommentar etc.
Textfeld1	ans..30	O	Card holder information: Name	Karteninhaber-Information: Name
Textfeld2	ans..30	O	Card holder information: City	Karteninhaber-Information: Ort
TransactionID	an..150	M	Additional reference number	Zusätzliche Referenznummer

Parameters for credits of credit card payments without reference

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Response_Intro
PageWithExcerpt	Reuse API

Table Filter

inverse	false
sparkName	Sparkline
hidePane	true
isNew	false
separator	Point (.)
ddSeparators	true
default	Beschreibung
isFirstTimeEnter	false
hideColumns	true
datepattern	dd M yy
id	1656941352752_-1183866370
worklog	365\|5\|8\|y w d h m\|y w d h m
isOR	AND
order	0

Multiexcerpt

MultiExcerptName	creditex_response

Table Transformer

dateFormat	dd M yy
export-word	false
show-source	false
export-csv	false
id	1634195378896_1171061233
transpose	false
worklog	365\|5\|8\|y w d h m\|y w d h m
separator	.
export-pdf	false
sql	SELECT * FROM T*

Table Excerpt Include

static	true
name	MID
page	mid
type	page

Table Excerpt Include

static	true
name	PayID
page	PayID
type	page

Table Excerpt Include

static	true
name	XID
page	XID
type	page

Table Excerpt Include

static	true
name	TransID
page	TransID
type	page

Table Excerpt Include

static	true
name	Status_OK_FAILED
page	Status
type	page

Table Excerpt Include

static	true
name	Description
page	Description
type	page

Table Excerpt Include

static	true
name	Code
page	Code
type	page

Response parameters for credits of credit card payments without reference

Reversal

A credit card authorisation lowers the customer's credit line.

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Platform-Kurz
PageWithExcerpt	Wording

can reverse an authorisation so that it no longer block the limit any more. Use the following URL:

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	BaseURL
PageWithExcerpt	Wording

reverse.aspx

Notice: Reverse.aspx does not only reverse authorisations, but any LAST TRANSACTION STAGE!! If the last transaction was a capture, Reverse.aspx initiates the reverse, e.g. a credit. Therefore, the utmost caution is urged. Use is at your own risk. We recommend checking the transaction status with Inquire.aspx before using Reverse.aspx.

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Request_Intro
PageWithExcerpt	Reuse API

Table Filter

inverse	false
sparkName	Sparkline
hidePane	true
isNew	false
separator	Point (.)
ddSeparators	true
default	Beschreibung
isFirstTimeEnter	false
hideColumns	true
datepattern	dd M yy
id	1656941418075_-229155742
worklog	365\|5\|8\|y w d h m\|y w d h m
isOR	AND
order	0

Multiexcerpt

MultiExcerptName	Reverse_request

Table Transformer

dateFormat	dd M yy
export-word	false
show-source	false
export-csv	false
id	1634196476888_-330309387
transpose	false
worklog	365\|5\|8\|y w d h m\|y w d h m
separator	.
export-pdf	false
sql	SELECT * FROM T*

Table Excerpt Include

static	true
name	MerchantID
page	MerchantID
type	page

Table Excerpt Include

static	true
name	PayID
page	PayID
type	page

Table Excerpt Include

static	true
name	TransID
page	TransID
type	page

Table Excerpt Include

static	true
name	Amount
page	Amount
type	page

Table Excerpt Include

static	true
name	Currency
page	Currency
type	page

Table Excerpt Include

static	true
name	MAC
page	MAC
type	page

Table Excerpt Include

static	true
name	ReqId-ans..32
page	ReqId
type	page

Parameters for reversals of credit card payments

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Response_Intro
PageWithExcerpt	Reuse API

Table Filter

inverse	false
sparkName	Sparkline
hidePane	true
isNew	false
separator	Point (.)
ddSeparators	true
default	Beschreibung
isFirstTimeEnter	false
hideColumns	true
datepattern	dd M yy
id	1656941549271_729570597
worklog	365\|5\|8\|y w d h m\|y w d h m
isOR	AND
order	0

Multiexcerpt

MultiExcerptName	Reverse_response

Table Transformer

dateFormat	dd M yy
export-word	false
show-source	false
export-csv	false
id	1634196622506_1344936154
transpose	false
worklog	365\|5\|8\|y w d h m\|y w d h m
separator	.
export-pdf	false
sql	SELECT * FROM T*

Table Excerpt Include

static	true
name	MID
page	mid
type	page

Table Excerpt Include

static	true
name	PayID
page	PayID
type	page

Table Excerpt Include

static	true
name	XID
page	XID
type	page

Table Excerpt Include

static	true
name	TransID
page	TransID
type	page

Table Excerpt Include

static	true
name	Status_OK_FAILED
page	Status
type	page

Table Excerpt Include

static	true
name	Description
page	Description
type	page

Table Excerpt Include

static	true
name	Code
page	Code
type	page

Response parameters for reversals of credit card payments

Reversal (of partial authorization)

A credit card authorisation lowers the customer's credit line.

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Platform-Kurz
PageWithExcerpt	Wording

can after one or multiple partial captures have been completed, offer to reverse part of the still valid authorisation, so that it no longer blocks the remaining amount any more.

Use the following URL:

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	BaseURL
PageWithExcerpt	Wording

reverse.aspx

Notice: The reversal of a still valid authorized amount is specific for iCard and the restriction is that it CAN ONLY BE USED ONCE! More than one attempt will result in an error.

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Request_Intro
PageWithExcerpt	Reuse API

Table Filter

inverse	false
sparkName	Sparkline
hidePane	true
isNew	false
separator	Point (.)
ddSeparators	true
default	Beschreibung
isFirstTimeEnter	false
hideColumns	true
datepattern	dd M yy
id	1656941633573_1244227465
worklog	365\|5\|8\|y w d h m\|y w d h m
isOR	AND
order	0

Multiexcerpt

MultiExcerptName	reversal_multiplepartial_request

Table Transformer

dateFormat	dd M yy
export-word	false
show-source	false
export-csv	false
id	1634207652116_-753655274
transpose	false
worklog	365\|5\|8\|y w d h m\|y w d h m
separator	.
export-pdf	false
sql	SELECT * FROM T*

Table Excerpt Include

static	true
name	MerchantID
page	MerchantID
type	page

Table Excerpt Include

static	true
name	PayID
page	PayID
type	page

Table Excerpt Include

static	true
name	TransID
page	TransID
type	page

Key	Format	CND	Description	Beschreibung
Amount	n..10	M	Amount in the smallest currency unit (e.g. EUR Cent) – the actual still authorized amount you wish to release	Betrag in der kleinsten Währungseinheit (z.B. EUR Cent) – der tatsächlich noch autorisierte Betrag, den Sie freigeben möchten

Table Excerpt Include

static	true
name	Currency
page	Currency
type	page

Table Excerpt Include

static	true
name	MAC
page	MAC
type	page

Key

Format

CND

Description

Beschreibung

RefNr

ns..30

O

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	RefNr_Ctsf_Text
PageWithExcerpt	Reuse API

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	RefNr_Ascii
PageWithExcerpt	Reuse API

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	RefNr_Ctsf_Text
PageWithExcerpt	DE:Reuse API

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	RefNr_Ascii
PageWithExcerpt	DE:Reuse API

XID

ans..32

M

XID of the authorization to be reversed, taken from the authorization response

XID von der Teilautorisierung, die storniert werden soll. Diese XID haben Sie bei der Autorisierung erhalten.

Table Excerpt Include

static	true
name	ReqId-ans..32
page	ReqId
type	page

Parameters for partial authorization reversal of credit card payments

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Response_Intro
PageWithExcerpt	Reuse API

Table Filter

inverse	false
sparkName	Sparkline
hidePane	true
isNew	false
separator	Point (.)
ddSeparators	true
default	Beschreibung
isFirstTimeEnter	false
hideColumns	true
datepattern	dd M yy
id	1656941670089_1364768689
worklog	365\|5\|8\|y w d h m\|y w d h m
isOR	AND
order	0

Multiexcerpt

MultiExcerptName	credit_multiplepartial_response

Table Transformer

dateFormat	dd M yy
export-word	false
show-source	false
export-csv	false
id	1634207675865_-2008735545
transpose	false
worklog	365\|5\|8\|y w d h m\|y w d h m
separator	.
export-pdf	false
sql	SELECT * FROM T*

Table Excerpt Include

static	true
name	MID
page	mid
type	page

Table Excerpt Include

static	true
name	PayID
page	PayID
type	page

Table Excerpt Include

static	true
name	XID
page	XID
type	page

Table Excerpt Include

static	true
name	TransID
page	TransID
type	page

Table Excerpt Include

static	true
name	Status_OK_FAILED
page	Status
type	page

Table Excerpt Include

static	true
name	Description
page	Description
type	page

Table Excerpt Include

static	true
name	Code
page	Code
type	page

Key

Format

CND

Description

Beschreibung

RefNr

ns..30

O

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	RefNr_Ctsf_Text
PageWithExcerpt	Reuse API

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	RefNr_Ascii
PageWithExcerpt	Reuse API

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	RefNr_Ctsf_Text
PageWithExcerpt	DE:Reuse API

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	RefNr_Ascii
PageWithExcerpt	DE:Reuse API

Response parameters for partial authorization reversal of credit card payments

Reversal of an authorisation extension

A credit card authorisation is valid for only 7 to 30 days. In order to maintain your payment claim in the case of longer delivery times,

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Platform-Kurz
PageWithExcerpt	Wording

enables the automatic renewal of the authorisation. Renewal of the authorisation is also important for instalments or partial deliveries because the outstanding amount is invalid in the case of partial captures.

If you use authorisation renewal,

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Platform-Kurz
PageWithExcerpt	Wording

renews your authorisations until the payment has been captured fully. Amongst other things the customer's card limit is reduced by the authorised amount. In order to restore the card limit again, for example because the order cannot be fully delivered, you need to specifically cancel the authorisation renewal with the following URL:

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	BaseURL
PageWithExcerpt	Wording

cancelAuth.aspx

Notice: CancelAuth cancels only the recurrence of the authorisation. If you wish to unblock the customer's card limit, please reverse the authorisation in accordance with the section above.

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Request_Intro
PageWithExcerpt	Reuse API

Table Filter

inverse	false
sparkName	Sparkline
hidePane	true
isNew	false
separator	Point (.)
ddSeparators	true
default	Beschreibung
isFirstTimeEnter	false
hideColumns	true
datepattern	dd M yy
id	1656941719918_-1970701022
worklog	365\|5\|8\|y w d h m\|y w d h m
isOR	AND
order	0

Multiexcerpt

MultiExcerptName	cancelAuth_request

Table Transformer

dateFormat	dd M yy
export-word	false
show-source	false
export-csv	false
id	1634196730930_-1314170945
transpose	false
worklog	365\|5\|8\|y w d h m\|y w d h m
separator	.
export-pdf	false
sql	SELECT * FROM T*

Table Excerpt Include

static	true
name	MerchantID
page	MerchantID
type	page

Table Excerpt Include

static	true
name	PayID
page	PayID
type	page

Key	Format	CND	Description	Beschreibung
TransID	ans..64	M	TransID for the identification of the payment process to be reversed	ID des Händlers zur Identifizierung des zu stornierenden Zahlungsvorgangs

Table Excerpt Include

static	true
name	MAC
page	MAC
type	page

Parameters for reversal of an authorisation extension

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Response_Intro
PageWithExcerpt	Reuse API

Table Filter

inverse	false
sparkName	Sparkline
hidePane	true
isNew	false
separator	Point (.)
ddSeparators	true
default	Beschreibung
isFirstTimeEnter	false
hideColumns	true
datepattern	dd M yy
id	1656941789425_1684650249
worklog	365\|5\|8\|y w d h m\|y w d h m
isOR	AND
order	0

Multiexcerpt

MultiExcerptName	cancelAuth_response

Table Transformer

isFirstTimeEnter	false
dateFormat	dd M yy
export-word	false
show-source	false
export-csv	false
id	1634196818091_1279578656
transpose	false
worklog	365\|5\|8\|y w d h m\|y w d h m
join-column	Key
separator	.
export-pdf	false
sql	SELECT * FROM T*

Table Excerpt Include

static	true
name	MID
page	mid
type	page

Table Excerpt Include

static	true
name	PayID
page	PayID
type	page

Table Excerpt Include

static	true
name	TransID
page	TransID
type	page

Table Excerpt Include

static	true
name	Status_OK_FAILED
page	Status
type	page

Table Excerpt Include

static	true
name	Description
page	Description
type	page

Table Excerpt Include

static	true
name	Code
page	Code
type	page

Result parameters for reversals of an authorisation extension

Credit card payment via POS terminals

To make a credit card payment via a POS terminal (POS: Point of Sale), send the payment request to the following URL:

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	BaseURL
PageWithExcerpt	Wording

stationary.aspx

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Request_Intro
PageWithExcerpt	Reuse API

Table Filter

inverse	false
sparkName	Sparkline
hidePane	true
isNew	false
separator	Point (.)
ddSeparators	true
default	Beschreibung
isFirstTimeEnter	false
hideColumns	true
datepattern	dd M yy
id	1656941807352_1541721469
worklog	365\|5\|8\|y w d h m\|y w d h m
isOR	AND
order	0

Multiexcerpt

MultiExcerptName	stationary_request

Table Transformer

dateFormat	dd M yy
export-word	false
show-source	false
export-csv	false
id	1634197016100_1639416748
transpose	false
worklog	365\|5\|8\|y w d h m\|y w d h m
separator	.
export-pdf	false
sql	SELECT * FROM T*

Table Excerpt Include

static	true
name	MerchantID
page	MerchantID
type	page

Table Excerpt Include

static	true
name	TransID
page	TransID
type	page

Table Excerpt Include

static	true
name	Amount
page	Amount
type	page

Table Excerpt Include

static	true
name	Currency
page	Currency
type	page

Table Excerpt Include

static	true
name	MAC
page	MAC
type	page

Key

Format

CND

Description

Beschreibung

RefNr

ns..30

O

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	RefNr_Ctsf_Text
PageWithExcerpt	Reuse API

Format must be mutually agreed beforehand with

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Helpdesk-Name
PageWithExcerpt	Wording

!

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	RefNr_Ctsf_Text
PageWithExcerpt	DE:Reuse API

Das Format muss vorher mit

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	Helpdesk-Name
PageWithExcerpt	DE:Wording

abgestimmt werden!

CCNr

n..16

M

Credit card number at least 12-digit, numerical without spaces

Kreditkartennummer mind. 12stellig numerisch ohne Leerzeichen

CCCVC

n..4

O

Card verification number: The last 3 digits on the signature strip of the credit card. 4 numbers in the case of American Express.

Kartenprüfnummer: Die letzten 3 Ziffern auf dem Unterschriftsfeld der Kreditkarte. Bei American Express 4 Ziffern.

CCExpiry

n6

M

Expiry date of the credit card in the format YYYYMM, e.g. 201707.

Ablaufdatum der Kreditkarte im Format YYYYMM, z.B. 201707

CCBrand

a..22

M

Credit card brand.

Please note the spelling! According to table of credit card brands!

Kreditkartenmarke.

Bitte beachten Sie die Schreibweise gemäß Tabelle der Kreditkartenmarken!

Track2

ans..80

M

Hexadecimal data on track 2 of the credit card

Hexadezimale Daten auf Spur 2 der Kreditkarte

Track3

ans..80

M

Hexadecimal data on track 3 of the credit card

Hexadezimale Daten auf Spur 3 der Kreditkarte

OrderDesc

ans..768

M

Description of purchased goods, unit prices etc.

Beschreibung der gekauften Waren, Einzelpreise etc.

Table Excerpt Include

static	true
name	Capture
page	Capture
type	page

Table Excerpt Include

static	true
name	ReqId-ans..32
page	ReqId
type	page

Parameters for credit card payments via POS terminals

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Response_Intro
PageWithExcerpt	Reuse API

Table Filter

inverse	false
sparkName	Sparkline
hidePane	true
isNew	false
separator	Point (.)
ddSeparators	true
default	Beschreibung
isFirstTimeEnter	false
hideColumns	true
datepattern	dd M yy
id	1656941893997_6863346
worklog	365\|5\|8\|y w d h m\|y w d h m
isOR	AND
order	0

Multiexcerpt

MultiExcerptName	stationary_response

Table Transformer

isFirstTimeEnter	false
dateFormat	dd M yy
export-word	false
show-source	false
export-csv	false
id	1634197071299_-6099288
transpose	false
worklog	365\|5\|8\|y w d h m\|y w d h m
join-column	Key
separator	.
export-pdf	false
sql	SELECT * FROM T*

Table Excerpt Include

static	true
name	MID
page	mid
type	page

Table Excerpt Include

static	true
name	PayID
page	PayID
type	page

Table Excerpt Include

static	true
name	XID
page	XID
type	page

Table Excerpt Include

static	true
name	TransID
page	TransID
type	page

Key	Format	CND	Description	Beschreibung
Status	a..50	M	AUTHORIZED or FAILED. OK status applies only to Sale transactions.	AUTHORIZED oder FAILED. Nur bei Sale-Transaktionen lautet der Status OK.

Table Excerpt Include

static	true
name	Description
page	Description
type	page

Table Excerpt Include

static	true
name	Code
page	Code
type	page

Key	Format	CND	Description	Beschreibung
TID	n..20	M	Usually a nine-digit terminal number	In der Regel neunstellige Terminalnummer
AuthCode	ans..6	M	Acquiring Bank's authorisation code	Autorisierungscode des Acquirers

Response parameters for credit card payments via POS terminals

Reversal of POS credit card payments

To reverse the capture of a credit card payment via a stationary terminal, please use the following URL:

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	BaseURL
PageWithExcerpt	Wording

stationary_rev.aspx

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Request_Intro
PageWithExcerpt	Reuse API

Table Filter

inverse	false
sparkName	Sparkline
hidePane	true
isNew	false
separator	Point (.)
ddSeparators	true
default	Beschreibung
isFirstTimeEnter	false
hideColumns	true
datepattern	dd M yy
id	1656941993386_-2069671016
worklog	365\|5\|8\|y w d h m\|y w d h m
isOR	AND
order	0

Multiexcerpt

MultiExcerptName	stationary_rev_request

Table Transformer

dateFormat	dd M yy
export-word	false
show-source	false
export-csv	false
id	1634197147157_71681145
transpose	false
worklog	365\|5\|8\|y w d h m\|y w d h m
separator	.
export-pdf	false
sql	SELECT * FROM T*

Table Excerpt Include

static	true
name	MerchantID
page	MerchantID
type	page

Table Excerpt Include

static	true
name	PayID
page	PayID
type	page

Table Excerpt Include

static	true
name	XID
page	XID
type	page

Key	Format	CND	Description	Beschreibung
TransID	ans..64	M	ID of merchant for the identification of the payment process to be reversed	ID des Händlers zur Identifizierung des zu stornierenden Zahlungsvorgangs

Table Excerpt Include

static	true
name	MAC
page	MAC
type	page

Parameters for reversal of credit card payments via POS terminals

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Response_Intro
PageWithExcerpt	Reuse API

Table Filter

inverse	false
sparkName	Sparkline
hidePane	true
isNew	false
separator	Point (.)
ddSeparators	true
default	Beschreibung
isFirstTimeEnter	false
hideColumns	true
datepattern	dd M yy
id	1656942009792_488051089
worklog	365\|5\|8\|y w d h m\|y w d h m
isOR	AND
order	0

Multiexcerpt

MultiExcerptName	stationary_rev_response

Table Transformer

isFirstTimeEnter	false
dateFormat	dd M yy
export-word	false
show-source	false
export-csv	false
id	1634197194238_2053281397
transpose	false
worklog	365\|5\|8\|y w d h m\|y w d h m
join-column	Key
separator	.
export-pdf	false
sql	SELECT * FROM T*

Table Excerpt Include

static	true
name	MID
page	mid
type	page

Table Excerpt Include

static	true
name	PayID
page	PayID
type	page

Table Excerpt Include

static	true
name	TransID
page	TransID
type	page

Table Excerpt Include

static	true
name	Status_OK_FAILED
page	Status
type	page

Table Excerpt Include

static	true
name	Code
page	Code
type	page

Response parameters for reversal of credit card payments via POS terminals

PayNow

Silent Mode for credit cards with SSL and 3-D Secure method

PayNow links the benefits of

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Platform-Kurz
PageWithExcerpt	Wording

forms and Server-to-Server connections: As opposed to the

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Platform-Kurz
PageWithExcerpt	Wording

form, where the form is loaded from the

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Platform-Kurz
PageWithExcerpt	Wording

server by calling payssl.aspx, the PayNow form has to be provided by the merchant’s system. The form uses the same parameters as described here below.

In contrast to the

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Platform-Kurz
PageWithExcerpt	Wording

form, the parameters are not forwarded as URL parameters as is the case when calling the payssl.aspx, but as form input parameters. By the way for calling the PayNow.aspx the same parameters can be used as for PaySSL.aspx.

Note
Please notice that in case of Fallback to 3-D Secure 1.0 the URLSuccess or URLFailure is called with GET. Therefore your systems should be able to receive parameters both via GET and via POST.

Multiexcerpt

MultiExcerptName	paynow_LenData

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Platform-Kurz
PageWithExcerpt	Wording

-Formular

PayNow

payssl.aspx?MerchantID=[mid]&Len=[len]&Data=[data]

Code Block

language	xml

<form action=paynow.aspx>
<input type="hidden" name="MerchantID" value=[mid]>
<input type="hidden" name="Len"        value=[len]>
<input type="hidden" name="Data"       value=[data]>
:
</form>

The credit card data must be transmitted to paynow.aspx with the following parameters:

Table Filter

inverse	false
sparkName	Sparkline
hidePane	true
isNew	false
separator	Point (.)
ddSeparators	true
default	Beschreibung
isFirstTimeEnter	false
hideColumns	true
datepattern	dd M yy
id	1656942083596_1278241766
worklog	365\|5\|8\|y w d h m\|y w d h m
isOR	AND
order	0

Multiexcerpt

MultiExcerptName	paynow_request

Table Transformer

isFirstTimeEnter	false
dateFormat	dd M yy
export-word	false
show-source	false
export-csv	false
id	1634197243419_231909840
transpose	false
worklog	365\|5\|8\|y w d h m\|y w d h m
join-column	Key
separator	.
export-pdf	false
sql	SELECT * FROM T*

Key	Format	CND	Description	Beschreibung
CCNr	n..16	M	Credit card number at least 12-digit, numerical without spaces	Kreditkartennummer: mindestens 12stellig ohne Leerzeichen
CCCVC	n3	O	Card verification number: The last 3 digits on the signature strip of the credit card	Kartenprüfnummer: Die letzten 3 Ziffern auf dem Unterschriftsfeld der Kreditkarte
CCExpiry	n6	M	Expiry date of the credit card in the format YYYYMM, e.g. 201807.	Ablaufdatum der Kreditkarte im Format YYYYMM, z.B. 201807
CCBrand	a..22	M	Credit card brand. Please note the spelling! According to table of credit card brands!	Kreditkartenmarke. Bitte beachten Sie die Schreibweise gemäß Tabelle der Kreditkartenmarken!

PayNow parameters for 3-D Secure method

After the customer has entered his credit card data, the payment data is forwarded to the PayNow page, where the further payment processing takes place via 3-D Secure. The form details must be directly forwarded to the PayNow page and may not be transmitted to the merchant’s system! Also, no PCI-relevant data may be transmitted to the PayNow page as additional input parameters!

Batch processing via the interface

Basic information about using Batch files and about their structure can be found in the Batch Manager manual. Within batch processing not alle functions are available which are usually available for the online interface.

Batch calls and answers

This section describes the parameters which must be transferred within the data set (Record) for executing a credit card payment and which information can be found within the response file about the payment status.

Notice: Within Batch process not all functions of online interface are available.

For Batch calls there must be considered batch versions, from which optional parameters depend. All version designations starting with „2.“ pertain calls for a group of enterprises. That means within a batch file for a particular MerchantID can be transferred transactions for other merchants with a separate Sub-MID.

For the connections ECPCC, GMO, Kalixa and SafeCharge the possible actions are limited to Capture, Credit and Reverse.

Following table gives an overview of all batch versions that are possible for a specific action and their specialities:

Table Filter

inverse	false
sparkName	Sparkline
hidePane	true
isNew	false
separator	Point (.)
ddSeparators	true
default	Beschreibung
isFirstTimeEnter	false
hideColumns	true
datepattern	dd M yy
id	1656942095746_888070793
worklog	365\|5\|8\|y w d h m\|y w d h m
isOR	AND
order	0

Multiexcerpt

MultiExcerptName	batch_versions

Table Transformer

isFirstTimeEnter	false
dateFormat	dd M yy
export-word	false
show-source	false
export-csv	false
id	1634197386707_763386583
transpose	false
worklog	365\|5\|8\|y w d h m\|y w d h m
join-column	Key
separator	.
export-pdf	false
sql	SELECT * FROM T*

Action	Version	Description	Beschreibung
Authorize	1.2 / 2.2	with textfeld1, textfeld2, RTF, cardholder, transactionID, schemeReferenceID	mit textfeld1, textfeld2, RTF, cardholder, transactionID, schemeReferenceID
	1.21 / 2.21	with textfeld1, textfeld2, RTF, approvalcode, cardholder, transactionID, schemeReferenceID	mit textfeld1, textfeld2, RTF, approvalcode, cardholder, transactionID, schemeReferenceID
	1.3 / 2.3	with CVC, transactionID, schemeReferenceID	mit CVC, transactionID, schemeReferenceID
	1.5 / 2.5	with CVC, Zone	mit CVC, Zone
Capture	1.2 / 2.2	with textfeld1, textfeld2	mit textfeld1, textfeld2
	1.21 / 2.21	with textfeld1, textfeld2, approvalcode	mit textfeld1, textfeld2, approvalcode
	1.4 / 2.4	with stop of authorisation renewal (FinishAuth)	mit Stopp der Autorisierungsverlängerung (FinishAuth)
CaptureEx	1.3 / 2.3	with CVC	mit CVC
Credit	1.2 / 2.2	with textfeld1, textfeld2	mit textfeld1, textfeld2
	1.21 / 2.21	with textfeld1, textfeld2	mit textfeld1, textfeld2
	1.4 / 2.4	with stop of authorisation renewal (FinishAuth)	mit Stopp der Autorisierungsverlängerung (FinishAuth)
CreditEx	1.2 / 2.2	with textfeld1, textfeld2	mit textfeld1, textfeld2
	1.21 / 2.21	with textfeld1, textfeld2	mit textfeld1, textfeld2
	1.3 / 2.3	with textfeld1, textfeld2	mit textfeld1, textfeld2
Sale	1.2 / 2.2	with textfeld1, textfeld2, RTF, cardholder, transactionID, schemeReferenceID	mit textfeld1, textfeld2, RTF, cardholder, transactionID, schemeReferenceID
	1.21 / 2.21	with textfeld1, textfeld2, RTF, approvalcode, cardholder, transactionID, schemeReferenceID	mit textfeld1, textfeld2, RTF, approvalcode, cardholder, transactionID, schemeReferenceID
	1.3 / 2.3	with CVC, textfeld1, textfeld2, transactionID, schemeReferenceID	mit CVC, textfeld1, textfeld2, transactionID, schemeReferenceID
	1.5 / 2.5	with CVC, Zone	mit CVC, Zone
Reverse	1.x / 2.x	Standard version	Standardversion

Description of the possible batch versions

The structure for a credit card payment within a Batch file to be submitted is the following:

Multiexcerpt

MultiExcerptName	batch_structure

Code Block

language	xml

HEAD,<MerchantID>,<Date>,<Version>
CC,Authorize,<Amount>,<Currency>,<TransID>,(<RefNr>),<CCBrand>,<CCNr|PCNr>, [<CCCVC>,]<CCExpiry>,<OrderDesc>[,<textfeld1>,<textfeld2>,<RTF>,<approvalcode>,<cardholder>,<Zone>,<transactionID>,<schemeReferenceID>]
CC,Capture,<Amount>,<Currency>,<TransID>,(<RefNr>),<PayID>,[<FinishAuth,<textfeld1>,<textfeld2>,<approvalcode>]
CC,Sale,<Amount>,<Currency>,<TransID>,(<RefNr>),<CCBrand>,<CCNr|PCNr>, [<CCCVC>,]<CCExpiry>,<OrderDesc>[,<textfeld1>,<textfeld2>,<RTF>,<approvalcode>,<cardholder>,<Zone>,<transactionID>,<schemeReferenceID>]]
CC,Credit,<Amount>,<Currency>,<TransID>,(<RefNr>),<PayID>[,<FinishAuth>,<textfeld1>,<textfeld2>]
CC,CreditEx,<Amount>,<Currency>,<TransID>,(<RefNr>),<CCBrand>,<CCNr|PCNr>, [<CCCVC>,]<CCExpiry>,<OrderDesc>[,<textfeld1>,<textfeld2>]
CC,Reverse,<Amount>,<Currency>,<TransID>,(<RefNr>),<PayID>
FOOT,<CountRecords>,<SumAmount>

Example for batch versions:

Multiexcerpt

MultiExcerptName	batch_examples

Code Block

language	xml
title	Version 1.2

CC,Sale,<Amount>,<Currency>,<TransID>,(<RefNr>),<CCBrand>,<CCNr|PCNr>,<CCExpiry>,<OrderDesc>
CC,Sale,<Amount>,<Currency>,<TransID>,(<RefNr>),<CCBrand>,<CCNr|PCNr>,<CCExpiry>,<OrderDesc>,<textfeld1>,<textfeld2>,<RTF>,<cardholder>,<transactionID>,<schemeReferenceID>

Code Block

language	xml
title	Version 1.21

CC,Sale,<Amount>,<Currency>,<TransID>,(<RefNr>),<CCBrand>,<CCNr|PCNr>,<CCExpiry>,<OrderDesc>,<textfeld1>,<textfeld2>,<RTF>,<approvalcode>,<cardholder>,<transactionID>,<schemeReferenceID>

Code Block

language	xml
title	Version 1.3

CC,Sale,<Amount>,<Currency>,<TransID>,(<RefNr>),<CCBrand>,<CCNr|PCNr>,<CCCVC>,<CCExpiry>,<OrderDesc>,<textfeld1>,<textfeld2>,<transactionID>,<schemeReferenceID>

Code Block

language	xml
title	Version 1.5

CC,Sale,<Amount>,<Currency>,<TransID>,(<RefNr>),<CCBrand>,<CCNr|PCNr>,<CCCVC>,<CCExpiry>,<OrderDesc>,<Zone>

Example for Master MID function:

Multiexcerpt

MultiExcerptName	batch_mastermid

Code Block

language	xml

HEAD,[Master]MerchantID,Date,2.x
Type,Action,[Slave]MID,Amount,Currency,TransID,Data (depends on Action)
FOOT,CountRecords,SumAmount

The following table describes the individual fields and values used within the data set (record) in the batch file:

Table Filter

inverse	false
sparkName	Sparkline
hidePane	true
isNew	false
separator	Point (.)
ddSeparators	true
default	Beschreibung
isFirstTimeEnter	false
hideColumns	true
datepattern	dd M yy
id	1656942143234_-1981708958
worklog	365\|5\|8\|y w d h m\|y w d h m
isOR	AND
order	0

Multiexcerpt

MultiExcerptName	batch_request

Table Transformer

dateFormat	dd M yy
export-word	false
show-source	false
export-csv	false
id	1634197386710_1955591063
transpose	false
worklog	365\|5\|8\|y w d h m\|y w d h m
separator	.
export-pdf	false
sql	SELECT * FROM T*

Key

Format

CND

Description

Beschreibung

Type

a..11

M

HEAD for Header, FOOT for Footer, CC for credit card

HEAD für Header, FOOT für Footer, CC für Kreditkarte

Action

a..20

M

The parameter Action defines the type of transaction:

Authorize (authorisation)

Capture

Sale

Credit

CreditEx (credit note without previous capture; please agree this with

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Helpdesk-Name
PageWithExcerpt	Wording

beforehand)

Reverse (cancellation)

Der Action-Parameter definiert die Art der Transaktion:

Authorize (Autorisierung)

Capture (Buchung)

Sale (Verkauf)

Credit (Gutschrift)

CreditEx (Gutschrift ohne vorherige Buchung; bitte stimmen sie sich hierzu vorher mit dem

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	Helpdesk-Name
PageWithExcerpt	DE:Wording

ab)

Reverse (Storno)

Table Excerpt Include

static	true
name	Amount
page	Amount
type	page

Table Excerpt Include

static	true
name	Currency
page	Currency
type	page

Table Excerpt Include

static	true
name	PayID
page	PayID
type	page

Key

Format

CND

Description

Beschreibung

TransID

ans..64

M

TransactionID which should be unique for each payment.

Please note for some connections the different formats that are given within the specific parameters.

TransaktionsID, die für jede Zahlung eindeutig sein muss.

Bitte beachten Sie bei einigen Anbindungen die abweichenden Formate, die bei den spezifischen Parametern angegeben sind.

RefNr

ns..30

O

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	RefNr_Ctsf_Text
PageWithExcerpt	Reuse API

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	RefNr_Ascii
PageWithExcerpt	Reuse API

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	RefNr_Ctsf_Text
PageWithExcerpt	DE:Reuse API

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	RefNr_Ascii
PageWithExcerpt	DE:Reuse API

OrderDesc

ans..127

O

Description of purchased goods, unit prices etc.

Beschreibung der gekauften Waren, Einzelpreise etc.

CCBrand

a..22

C

Credit card brand.

Please note the spelling! According to table of credit card brands!

Kreditkartenmarke.

Bitte beachten Sie die Schreibweise gemäß Tabelle der Kreditkartenmarken!

CCNr

n..16

C

Credit card number at least 12-digit, numerical without spaces. You can optionally transmit also a pseudo card number (PCN).

Kreditkartennummer mind. 12stellig numerisch ohne Leerzeichen. Optional können Sie auch eine Pseudokartennummer (PKN) übergeben.

Table Excerpt Include

static	true
name	PCNr
page	PCNr
type	page

Table Excerpt Include

static	true
name	CCExpiry_Response
page	CCExpiry
type	page

Key

Format

CND

Description

Beschreibung

CCCVC

n..4

O

Card verification number in Version 1.3: In the case of Visa and MasterCard the last 3 numbers on the signature strip of the credit card. 4 numbers in the case of American Express.

Kartenprüfnummer in Version 1.3: Bei Visa und MasterCard die letzten 3 Ziffern auf dem Unterschriftsfeld der Kreditkarte. Bei American Express 4 Ziffern.

FinishAuth

ans1

O

Version=1.4: If using the authorisation renewal, cancel repeat with the value Y in the field FinishAuth in the case of Capture or Credit. Example: You capture a partial delivery. The rest of the order cannot be supplied. You therefore enter Y in the FinishAuth field for Part-capture so that the

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Platform-Kurz
PageWithExcerpt	Wording

does not authorise the remaining amount. Please note for this also the following section about Cancel authorisation renewals.

Version=1.4: Wenn Sie die Autorisierungsverlängerung nutzen, stoppen Sie die Wiederholung mit dem Wert Y im Feld FinishAuth bei Capture oder Credit. Beispiel: Sie buchen eine Teillieferung. Der Rest der Bestellung ist nicht lieferbar. Daher übergeben Sie beim Capture der Teilbuchung im Feld FinishAuth Y, damit das

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	Platform-Kurz
PageWithExcerpt	DE:Wording

den Restbetrag nicht wieder au-torisiert. Beachten Sie dazu auch den folgenden Abschnitt zum Stopp von Autorisierungsverlängerungen.

Description of fields within the record for Batch files

The record area within the response file for Batch transactions looks as follows:

Multiexcerpt

MultiExcerptName	batch_transactions

Code Block

language	xml

HEAD,<MerchantID>,<Date>,<Version>
CC,Authorize,<Amount>,<Currency>,<TransID>,(<RefNr>),<PayID>,<CCBrand>,<CCNr|PCNr>,[<CCCVC>,]<CCExpiry>,<OrderDesc>[,<textfeld1>,<textfeld2>,<RTF>,<approvalcode>,<cardholder>,<Zone>,<transactionID>,<schemeReferenceID>],<Status>,<Code>
CC,Capture,<Amount>,<Currency>,<TransID>,(<RefNr>),<PayID>[<textfeld1>,<textfeld2>,<approvalcode>],<Status>,<Code>
CC,AuthSplit,<Amount>,<Currency>,<TransID>,(<RefNr>),<PayID>,FAILED,<Code>,<Description>,[<PCNr>]
CC,Renewal,<Amount>,<Currency>,<TransID>,(<RefNr>),<PayID>,FAILED,<Code>,<Description>,[<PCNr>]
CC,Sale,<Amount>,<Currency>,<TransID>,(<RefNr>),<PayID>,<CCBrand>,<CCNr|PCNr>,[<CCCVC>,]<CCExpiry>,<OrderDesc>[,<textfeld1>,<textfeld2>,<RTF>,<approvalcode>,<cardholder>,<Zone>,<transactionID>,<schemeReferenceID>],<Status>,<Code>
CC,Credit,<Amount>,<Currency>,<TransID>,(<RefNr>),<PayID>[,<FinishAuth>,<textfeld1>,<textfeld2>],<Status>,<Code>
CC,CreditEx,<Amount>,<Currency>,<TransID>,(<RefNr>),<CCBrand>,<CCNr|PCNr>,[<CCCVC>,]<CCExpiry>,<OrderDesc>[,<textfeld1>,<textfeld2>],<Status>,<Code>
CC,Reverse,<Amount>,<Currency>,<TransID>,(<RefNr>),<PayID>,<Status>,<Code>
FOOT,<CountRecords>,<SumAmount>

Example for batch versions:

Multiexcerpt

MultiExcerptName	batch_examples_response

Code Block

language	xml
title	Version 1.2

CC,Sale,<Amount>,<Currency>,<TransID>,(<RefNr>),<CCBrand>,<CCNr|PCNr>,<CCExpiry>,<OrderDesc>,<Status>,<Code>
CC,Sale,<Amount>,<Currency>,<TransID>,(<RefNr>),<CCBrand>,<CCNr|PCNr>,<CCExpiry>,<OrderDesc>,<textfeld1>,<textfeld2>,<RTF>,<cardholder>,<transactionID>,<schemeReferenceID>,<Status>,<Code>

Code Block

language	xml
title	Version 1.21

CC,Sale,<Amount>,<Currency>,<TransID>,(<RefNr>),<CCBrand>,<CCNr|PCNr>,<CCExpiry>,<OrderDesc>,<textfeld1>,<textfeld2>,<RTF>,<approvalcode>,<cardholder>,<transactionID>,<schemeReferenceID>,<Status>,<Code>

Code Block

language	xml
title	Version 1.3

CC,Sale,<Amount>,<Currency>,<TransID>,(<RefNr>),<CCBrand>,<CCNr|PCNr>,<CCCVC>,<CCExpiry>,<OrderDesc>,<textfeld1>,<textfeld2>,<transactionID>,<schemeReferenceID>,<Status>,<Code>

Code Block

language	xml
title	Version 1.5

CC,Sale,<Amount>,<Currency>,<TransID>,(<RefNr>),<CCBrand>,<CCNr|PCNr>,<CCCVC>,<CCExpiry>,<OrderDesc>,<Zone>,<Status>,<Code>

The following table describes the response parameters which the Batch Manager saves in the Record area for each transaction (standard parameters not explained here, such as <TransID> or <RefNR> and request parameters are returned unchanged and correspond to the call as specified before):

Table Filter

inverse	false
sparkName	Sparkline
hidePane	true
isNew	false
separator	Point (.)
ddSeparators	true
default	Beschreibung
isFirstTimeEnter	false
hideColumns	true
datepattern	dd M yy
id	1656939586463_-928745244
worklog	365\|5\|8\|y w d h m\|y w d h m
isOR	AND
order	0

Multiexcerpt

MultiExcerptName	batch_response

Table Transformer

dateFormat	dd M yy
export-word	false
show-source	false
export-csv	false
id	1634197460581_1165028633
transpose	false
worklog	365\|5\|8\|y w d h m\|y w d h m
separator	.
export-pdf	false
sql	SELECT * FROM T*

Key	Format	CND	Description	Beschreibung
Action	a..20	M	The parameter Action defines the type of transaction like capture or credit – see above.	Der Action-Parameter definiert die Art der Transaktion wie Capture (Buchung) oder Credit (Gutschrift) – siehe oben.

Table Excerpt Include

static	true
name	PayID
page	PayID
type	page

Table Excerpt Include

static	true
name	Status_OK_FAILED
page	Status
type	page

Table Excerpt Include

static	true
name	Code
page	Code
type	page

Key	Format	CND	Description	Beschreibung
PCNr	n..16	C	The Pseudo Card Number is only returned in the case of transaction types Authorize or Sale & CreditEx. It starts with 0 and the last 3 digits correspond to those of the real card number.	Die Pseudo Card Number wird nur bei den Transaktionstypen Authorize oder Sale & CreditEx zurückgegeben. Sie beginnt mit 0, und die letzten 3 Stellen entsprechen denen der realen Kartennummer.

Description of result parameters within the record for Batch files

Cancel authorisation renewals

With a credit card authorisation you get the right to claim a payment. However an authorisation lasts only 30 days which is a problem if you capture a partial amount, for example as part payment for several partial shipments. In order to reproduce your payment request

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Platform-Kurz
PageWithExcerpt	Wording

can repeat an expired authorisation automatically.

If an order cannot be delivered or has been cancelled by the customer, it is very important that the automatic authorisations stop. Your customer's card limit will be otherwise reduced permanently because the

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Platform-Kurz
PageWithExcerpt	Wording

continues to charge your customer's card.

Under normal circumstances the

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Platform-Kurz
PageWithExcerpt	Wording

stops the automatic authorisation renewal when the authorised amount has been captured in full. In Batch version 1.4 you can also stop the authorisation renewal manually by changing the payment status. To perform this you submit a capture in your batch file whose amount is under the admissible limit. Since

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Platform-Kurz
PageWithExcerpt	Wording

refuses credit card captures below 1.00 euro, the payment status changes to FAILED in the case of lesser amounts.

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Platform-Kurz
PageWithExcerpt	Wording

therefore renews this authorisation no further. A corresponding capture entry of 0.05 euro’s is shown for example as follows:

CC,Capture,5,EUR,BestNr.0815,Rg.Nr.5180,a86dga4310d24453acd6f8a3112a769,y

Since the amount of 5 cents lies below the minimum amount of 1.00 euro,

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Platform-Kurz
PageWithExcerpt	Wording

refuses the capture with the error message MinValue. The payment status changes to FAILED and the authorisation renewal is stopped.

Space shortcuts

Page tree

Versions Compared

Old Version 65

New Version Current

Key

Specific parameters for iCard

Capture / Credit / Reversal

Capture

Capture (Multiple Partial)

Credit with reference

Credit with reference (for multiple captures)

Credit without reference

Reversal

Reversal (of partial authorization)

Reversal of an authorisation extension

Credit card payment via POS terminals

Reversal of POS credit card payments

PayNow

Silent Mode for credit cards with SSL and 3-D Secure method

Batch processing via the interface

Batch calls and answers

Cancel authorisation renewals

Paygate

Computop

Help

Intranet Tools

Space shortcuts

Page tree

Page History

Versions Compared

Old Version 65

New Version Current

Key

Specific parameters for iCard

Capture / Credit / Reversal

Capture

Capture (Multiple Partial)

Credit with reference

Credit with reference (for multiple captures)

Credit without reference

Reversal

Reversal (of partial authorization)

Reversal of an authorisation extension

Credit card payment via POS terminals

Reversal of POS credit card payments

PayNow

Silent Mode for credit cards with SSL and 3-D Secure method

Batch processing via the interface

Batch calls and answers

Cancel authorisation renewals