Introduction
Description of the changes which are required by easyCredit API update, which impacts Computop Paygate implementation and requires changes on the merchant side.
Required changes
Creation of Payment
API calls which are in scope of change are marked in red:
Changes are in 2 API calls:
2. Initial creation of payment
- changes in parameters
- new parameters
- modification of existing ones
- changes in parameters
11. Getting the information about transaction and financing
- response parameters "Decision" and "Process" are deprecated
- response parameter "Financing" is modified
- more data
- payload is in English, not in German
Capture & Credit
These Actions are now asynchronous.
This means, that Paygate will responde always with Status=Request and update the final Status asynchronously, by sending notification to URLNotify, defined in the initial payment creation.
Details are described below.
Detailed description of changes
1. Initial request to: https://www.computop-paygate.com/easyCredit.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:
New validation logic
- The delivery address must match the invoice address or it must be a packstation.
- FirstName and LastName of delivery and customer should match.
- The invoice address must match the delivery address.
- FirstName and LastName of Invoice Address and customer should match.
Example Request and Response
Example request
===============
MerchantID=YourMerchantID TransID=123456 RefNr=27022017_01 Amount=59995 Currency=EUR EventToken=INT URLFailure=https://your.shop.info/failure.aspx URLSuccess=https://your.shop.info/success.aspx URLNotify=https://your.shop.info/notify.aspx Salutation=MR FirstName=John LastName=Doe DateOfBirth=1999-02-02 bdFirstName=John bdLastName=Doe bdStreet=Schwarzenbergstraße bdStreetNr=4 bdAddressAddition=Computop GmbH bdZip=96050 bdCity=Bamberg bdCountryCode=DE PackingStation=NO sdFirstName=John sdLastName=Doe sdStreet=Schwarzenbergstraße sdStreetNr=4 sdAddressAddition=Computop GmbH sdZip=96050 sdCity=Bamberg sdCountryCode=DE Email=max@mustermann.de Employment=EMPLOYEE MonthlyNetIncome=100000 Phone=015124011444 CustomerSince=1999-02-02 CustomerLoggedIn=YES NumberOrders=1 ArticleList=ew0KCSJzaG9wcGluZ0NhcnRJbmZvcm1hdGlvbiI6IFsNCgkJew0KCQkJInByb2R1Y3ROYW1lIjogIldhc2hpbmcgTWFjaGluZSIsDQoJCQkicXVhbnRpdHkiOiAxLA0KCQkJInByaWNlIjogNTk5Ljk1LA0KCQkJIm1hbnVmYWN0dXJlciI6ICJTaWVtZW5zIiwNCgkJCSJwcm9kdWN0Q2F0ZWdvcnkiOiAiSG91c2Vob2xkIEFwcGxpYW5jZXMiLA0KCQkJImFydGljbGVOdW1iZXIiOiBbDQoJCQkgIHsNCgkJCQkibnVtYmVyVHlwZSI6ICJHVElOIiwNCgkJCQkibnVtYmVyIjogMTExMTExMQ0KCQkJICB9DQoJCQldDQoJCX0NCgldDQp9 version=v3
Example response
================
mid=YourMerchantID PayID=e8be1739b7754b68b4a53bbf33670efc TransID=123456 XID=b4b01e1654744bdd87fbb496cbbf79e1 refnr=27022017_01 Status=AUTHORIZE_REQUEST Code=0 Description=REQUEST
2. Retrieving information about installments https://www.computop-paygate.com/easyCreditDirect.aspx
The request remains the same. The parameter 'version=v3' ist not needed anymore.
The response now containes only the 'Financing' parameter instead of all three parameters 'Decision', 'Process' and 'Financing'.
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:
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
Example Request and Response
Example request
===============
MerchantID=YourMerchantID PayID=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX TransID=123456 RefNr=27022017_01 Amount=59995 Currency=EUR EventToken=GET
Example response
================
mid=YourMerchantID PayID=b1ecea6e3e8b426fbb614a14f901ac4a TransID=123456 XID=2e2b31055fbf445d91c6564947d63ffb refnr=27022017_01 financing= Status=AUTHORIZE_REQUEST Code=0 Description=REQUEST