Wallet Management

Implementation

Step 1: Generate signature

Use the following fields when generating a SHA256 signature (also called a checksum):

• Secret Key provided by Ecentric
• MerchantID provided by Ecentric
• UserID is a value generated by the merchant and is a unique reference to identify returning customers. The data type is ALPHANUMERIC only (no spaces or special characters).

📘

Important

The variables are required to be pipe ('|' ) delimited and the hashed value then converted to upper case.

Example: SHA256(“SecretKey|MerchantID|UserID”).Upper()

Step 2: Call Manage Wallet Page

Send an HTML form POST with the required fields (specified below) and signature to the endpoint URL: https://sandbox.ecentric.co.za/hpp/wallet/Manage

• MerchantID
• UserID
• ChecksumHash

Step 3: Process the response

The Gateway will return an HTML form POST with the response back to the URL that was provided by the merchant. The expected successful and failure transaction response fields are listed below. (See Hosted Payment Data Fields for further details regarding each field).

The response will include a checksum value generated by Ecentric using the calculation elements below. It is recommended that merchants implement their own checksum calculation and compare it to the value received in order to verify that the response data originated from Ecentric and has not been tampered with.