Response
Share Commerce will response different type of Pre-Auth transaction to Merchant with the status of transaction completion.
Merchant server shall examine field RespCode to determine the actual processing response of the request.
| Field Name | Data Type (Len) | M/O | Description |
|---|---|---|---|
| RespCode | String (30) | M | Payment response code (Refer to Appendix 1 - Response code) |
| RespMessage | String (2000) | M | Result description of a payment transaction |
| PaymentType | String (30) | M | Pre-Auth Payment Type (Refer to Appendix 3 - PreAuth Payment Type) |
| MerchantID | String (50) | M | Unique merchant ID assigned to each merchant by Share Commerce |
| TxnRefNo | String (50) | M | Unique reference of a transaction, generated by system |
| CurrencyCode | String (5) | M | Transaction currency |
| TxnAmount | Decimal (18,2) | M | Transaction amount |
| MerchantOrderNo | String (50) | M | MerchantOrderNo upon submission on Pre-Auth transaction |
| MerchantOrderDesc | String (2000) | M | Order description |
| MerchantPaymentNo | String (50) | M | Unique Merchant Payment No for every transaction request |
| MerchantRef1 | String (100) | O | Merchant reference 1 |
| MerchantRef2 | String (100) | O | Merchant reference 2 |
| MerchantRef3 | String (100) | O | Merchant reference 3 |
| CustReference | String (50) | O | Customer reference / indicator |
| CustName | String (150) | O | Customer name |
| CustEmail | String (150) | O | Customer email |
| CustPhoneNo | String (50) | O | Customer phone number |
| CustAddress1 | String (100) | O | Customer address line 1 |
| CustAddress2 | String (100) | O | Customer address line 2 |
| CustCountryCode | String (10) | O | Customer country code |
| CustAddressState | String (150) | O | Customer address state |
| CustAddressCity | String (150) | O | Customer address city |
| CustPostcode | String (10) | O | Customer postcode |
| PaymentMethod | String (100) | M | Payment Method selected by customer (Refer to Appendix 2 - Payment Method) |
| MaskedPAN | String (20) | Masked Card Number if payment via Credit/Debit Card. | |
| Versioning | Integer | M | API Version |
| TxnDateTime | Datetime | M | Transaction date time |
Legend:
M: Mandatory field.
O: Optional field. Value can be empty, but parameter must exist.
1. Sample of response (Redirect / Http GET)
https://[MerchantRedirectUrl]?RespCode=00
&RespDesc=Success
&PaymentType=PREAUTH
&MerchantID=MID0001
&TxnRefNo=3262873184
&CurrencyCode=MYR
&TxnAmount=100.00
&MerchantOrderNo=POST0001
&MerchantOrderDesc=perfume
&MerchantPaymentNo=AKSP172389123
&MerchantRef1=mref1
&MerchantRef2=mref2
&MerchantRef3=mref3
&CustReference=ctRefIC111
&CustName=TomTom
&CustEmail=tomt%40email.com
&CustPhoneNo=01938668396
&CustAddress1=add1
&CustAddress2=add2
&CustCountryCode=MY
&CustAddressState=semenyih
&CustAddressCity=selangor
&CustPostcode=12345
&PaymentMethod=CARD
&MaskedPAN=545301XXXXXX1234
&Versioning=2
&TxnDateTime=2022-06-13%2015%3A49.12
&SCSign=ec0a47f774a003842042d8be1a448ce58f026cdd6c9bb087960f400a7a65ff18
*Note, above is one line string url.
2. Sample of response (Http POST)
{
"RespCode": "00",
"RespDesc": "Success",
"PaymentType": "PREAUTH",
"MerchantID": "MID0001",
"TxnRefNo": "3262873184",
"CurrencyCode": "MYR",
"TxnAmount": 100.00,
"MerchantOrderNo": "POST0001",
"MerchantOderDesc": "Perfume",
"MerchantPaymentNo": "AKSP172389123",
"MerchantRef1": "mref1",
"MerchantRef2": "mref2",
"MerchantRef3": "mref3",
"CustReference": "ctRefIC111",
"CustName": "TomTom",
"CustEmail": "tomt%40email.com",
"CustPhoneNo": "01938668396",
"CustAddress1": "add1",
"CustAddress2": "add2",
"CustCountryCode": "MY",
"CustAddressState": "semenyih",
"CustAddressCity": "selangor",
"CustPostcode": "12345",
"PaymentMethod": "CARD",
"MaskedPAN": "545301XXXXXX1234",
"Versioning": 2,
"TxnDateTime": "2022-06-13 15:49.12",
"SCSign": "ec0a47f774a003842042d8be1a448ce58f026cdd6c9bb087960f400a7a65ff18"
}
SCSign Calculation (Http GET & POST)
SCSign generation will concat all the above Table Field's value (in sequence), with HMACSHA256.
Concat all the value (refer to Sample)
String to sign :
00SuccessPREAUTHMID000013262873184MYR101.50POST0001perfumeAKSP172389123mref1mref2mref3ctRefIC111TomTomtomt@email.com01938668396add1add2MYsemenyihselangor12345CARD545301XXXXXX123422022-06-13 15:49.12
Calculate with HMACSHA256
Secret Key : mSuE3Ttn5B8vJhe5ncMutMLV
SCSign : ec0a47f774a003842042d8be1a448ce58f026cdd6c9bb087960f400a7a65ff18