About girocard e-commerce
E-commerce payments with girocard are currently only possible via Apple Pay.
This page is describing solution for merchant's own decryption of Apple Pay payload (token) for recurring payments.
For standard Apple Pay integration (including Girocard), please refer to Apple Pay documentation.
Paygate interface: via Server-to-Server
Format Description a alphabetical as alphabetical with special characters n numeric an alphanumeric ans alphanumeric with special characters ns numeric with special characters bool boolean expression (true or false) 3 fixed length with 3 digits/characters ..3 variable length with maximum 3 digits/characters enum enumeration of allowed values dttm ISODateTime (YYYY-MM-DDThh:mm:ss) Abbreviation Description CND condition M mandatory O optional C conditional Notice: Please note that the names of parameters can be returned in upper or lower case.Definitions
Data formats
Abbreviations
Comment If a parameter is mandatory, then it must be present If a parameter is optional, then it can be present, but it is not required If a parameter is conditional, then there is a conditional rule which specifies whether it is mandatory or optional
Request elements
In order to start a server-to-server girocard e-commerce payment, please use the following URL:
https://www.computop-paygate.com/girocard.aspx |
Notice: For security reasons, Computop Paygate rejects all payment requests with formatting errors. Therefore, please use the correct data type for each parameter. The following table describes the encrypted payment request parameters:
Parameters for girocard e-commerce payment
Response elements
The following table describes the result parameters with which the Computop Paygate responds to your system
pls. be prepared to receive additional parameters at any time and do not check the order of parameters the key (e.g. MerchantId, RefNr) should not be checked case-sentive
Response parameters for girocard e-commerce payments
JSON object tokenData
Schema
BASEURL= https://www.computop-paygate.com/schemas
{
"$schema": "http://json-schema.org/draft-07/schema#",
"$id": "BASEURL/tokenData.json",
"title": "tokenData",
"description": "Token Data",
"type": "object",
"properties": {
"tokenCryptogram": {
"type": "string",
"description": "Token cryptogram."
},
"eci": {
"type": "string",
"description": "Electronic Commerce Indicator."
},
"tokenRequestor": {
"type": "string",
"description": "Token requestor."
},
"tokenRequestorID": {
"type": "string",
"description": "Token requestor ID."
}
},
"required": ["tokenCryptogram", "tokenRequestor, "eci"],
"additionalProperties": false
}
Sample
{
"tokenCryptogram": "YwAAErsAAcll8GEDuiS4gFlgAgA=",
"eci": "7",
"tokenRequestor": "merchantTokenization",
"tokenRequestorID": "50129390584"
}
Recurring payments
Girocard e-commerce offers the possibility of recurring payments, which must always reference initial payment done via Apple Pay.
These recurring payments are not online authorized with the issuing bank, but only included in the clearing file.
Please note, that since there is no online authorization (validation) at the time of recurring payment, the account might not have enough funds or might not exist.
Request elements
In order to start a server-to-server girocard e-commerce payment, please use the following URL:
https://www.computop-paygate.com/girocard.aspx |
Notice: For security reasons, Computop Paygate rejects all payment requests with formatting errors. Therefore, please use the correct data type for each parameter. The following table describes the encrypted payment request parameters:
Parameters for recurring payments
Response elements
The following table describes the result parameters with which the Computop Paygate responds to your system pls. be prepared to receive additional parameters at any time and do not check the order of parameters the key (e.g. MerchantId, RefNr) should not be checked case-sentive
Response parameters for recurring payments