Introduction
The idea of Paygate is to store customer data like credit card data, billing / shipping address in a secure way within Paygate and to re-use these data based on CustomerId.
The Customer Data Storage (CDS) refers to a Scope which can be used to share the same CDS data with multiple of your MerchantIds.
After Customer Data Storage has been activated for your MerchantId within Paygate:
- initial usage / consumer has no data stored yet
- you can send CustomerId in Paygate-request
- the consumer will be asked on Hosted Payment Page / Credit Card Form (PaySSL) whether the payment data should be stored
- payment request is completed
- and you will be notified for updates on Customer Data Storage
- subsequent usage / consumer has already data stored
- you still send CustomerId in Paygate-request
- the credit card data will be prefilled Hosted Payment Page / Credit Card Form (PaySSL)
- the consumer needs to add CVC, only - as CVC must not be stored at any time
- payment request is completed
Currently storage of credit card data is supported, only. Support for other payment data and other consumer data may be added in a later stage.
Paygate interface
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
Notifications on Customer Data Storage updates
With activation of Customer Data Storage (CDS) by Computop Helpdesk you will need to provide a URL to receive notifications for CDS updates. The data will be sent as POST-request and data are part of request-body.
Notifications for CDS-updates are not encrypted, because they do not contain sensitive data.
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
Customer Data Storage (CDS) inquiries
CDS request
CDS inquiries within Paygate return stored CDS data for a given CustomerId or CustomerReferenceId.
https://www.computop-paygate.com/customer.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 CDS inquiries via socket connections
CDS response
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 in the case of CDS inquiries via socket connections
CDS details (Type: CreditCard)
{
"CustomerReferenceId": "5912cfe4abbb453499120bf71f85be6f",
"CustomerId": "123123",
"MID": "Your_MerchantId",
"Scope": "Your_Scope",
"Created": "2023-12-21T12:10:58.087",
"Changed": "2023-12-21T12:10:58.087",
"CustomerDataInfos": [
{
"CCNrMasked": "411111xxxxxx1111",
"Expiry": "202701",
"Holder": "John Doe",
"Brand": "VISA",
"PCNr": "0605262127687111",
"Type": "CreditCard",
"CustomerDataId": "9de5132163cf4c838ffd7695e2d6b542",
"CustomerReferenceId": "5912cfe4abbb453499120bf71f85be6f",
"Scope": "Your_Scope",
"Active": true,
"LastUsed": "2023-12-21T12:10:58.087",
"Created": "2023-12-21T12:10:58.087",
"Changed": "2023-12-21T12:10:58.087"
}
]
}