Versions Compared

Old Version 1

changes.mady.by.user Admin

Saved on

compared with

New Version 2

changes.mady.by.user Admin

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Published by Scroll Versions from space ENWORK and version Documentation

...

Step

Task

1

Please log on to Computop Support, which supplies you with the Hash password.

2

The HMAC value is calculated with the aid of the password and several parameter values. For the calculation, the parameters PayID, TransID, MerchantID, Amount and Currency are used and separated with asterisks:

PayID*TransID*MerchantID*Amount*Currency 

KeyValueComments
PayIdReferenced PayIdMay be empty, e.g. for creating an initial payment process or risk management request; is used with subsequent requests like capture/refund.
TransIdYour transactionId to reference / identify your requestYour own reference to identify each request / payment process.
MerchantIdYour MerchantId assigned to you by ComputopYour MerchantId identifiying this request.
AmountAmount in smallest unit of currency, e.g. 123=1,23Amount of this request; may be empty if not used, e.g. for status inquiries.
CurrencyCurrency of payment process in ISO 4217, e.g. EUR, USD, GBPCurrency of this request; may be empty if not used, e.g. for status inquiries.
YourHmacPasswortYour MAC-password assigned to you by ComputopYour MAC-password assigned to a specific MID; if you have different MIDs you will have different MAC passwords, too.

Notice: If a transaction does not support all of these parameters, you can simply omit the missing value.

For example, there is no PayID yet with the first transaction, so you do not have to transfer this. The PayID is a component of the Hash calculation in subsequent transactions:

Samples for MAC calculationFormulaResult
without PayId, with amount/currencysha256("*TID-4453732122167114558*yourMerchantId*1234*EUR", "mySecret")38ced807e293fc634a6c36ffaea7bd2687038d40615781918aef2de7bb9a990338CED807E293FC634A6C36FFAEA7BD2687038D40615781918AEF2DE7BB9A9903
without PayId, without TransId, with amount/currencysha256("**yourMerchantId*1234*EUR", "mySecret")ecbcab7361cffe1694d2e893280aed0feec2fcf518a736009d38cbd65f0dc68bECBCAB7361CFFE1694D2E893280AED0FEEC2FCF518A736009D38CBD65F0DC68B
with PayId, without amount/currencysha256("fe3f002e19814eea8aa733ec4fdacafe*TID-4453732122167114558*yourMerchantId**", "mySecret")5a3ed13e4bf3492166e8e9b5898f372735b6fdcbffc41b2ab4574a9a6fc9b7345A3ED13E4BF3492166E8E9B5898F372735B6FDCBFFC41B2AB4574A9A6FC9B734

3

Use the MAC SHA-256 algorithm, which nearly all programming languages support, in order to calculate the Hash value with the password and the parameter values.

4

Use the MAC parameter to transfer the hexadecimal encoded Hash value to the

Multiexcerpt include
SpaceWithExcerptEN
MultiExcerptNamePlatform-Kurz
PageWithExcerptWording
with each transaction in the encoded data field.

...