Pre Auth (Void)
The Pre-Auth Void request is acceptable with HTTPS POST method only.
Staging URL: https://stagingpayment.share-commerce.com/PreAuth/Void
Production URL: https://payment.share-commerce.com/PreAuth/Void
Request
Merchant need to pass in the following for Pre-Auth Void transaction.
| Field Name | Data Type (Len) | M/O | Description |
|---|---|---|---|
| MerchantID | String (50) | M | Unique merchant ID assigned to each merchant by Share Commerce |
| MerchantOrderNo | String (50) | M | MerchantOrderNo upon submission on Pre-Auth transaction |
| MerchantPaymentNo | String (50) | M | Unique Merchant Payment No for every transaction request |
| PreAuthTxnRefNo | String (50) | M | TxnRefNo from successful Pre-Auth transaction |
| VoidAmount | Decimal (18,2) | M | Pre-Auth transaction amount |
| Http Header | Data Type (Len) | M/O | Description |
|---|---|---|---|
| SCSign | M | Message sign (Refer to below SCSign Calculation section) |
*Note, field SCSign have to put in Http Header.
Request Sample
{
"MerchantID": "MID0001",
"MerchantOrderNo": "POST0001",
"MerchantPaymentNo": "AHS92738",
"PreAuthTxnRefNo": "8712893729013",
"VoidAmount": 101.50
}
SCSign Calculation (Request)
For Pre-Auth (Void), SCSign generation will based on the raw request send or raw response received, and calculate with HMACSHA256. And SCSign value have to be capture at Http Header.
Secret Key : mSuE3Ttn5B8vJhe5ncMutMLV
Raw Request
{"MerchantID":"MID0001","MerchantOrderNo":"POST0001","MerchantPaymentNo":"AHS92738","PreAuthTxnRefNo": "8712893729013","VoidAmount":101.50}
SCSign (Request) : 4038d4305e8936e0b5b525fab3d26d1ac51596c4379f685b2b235f119b11accd
Response
Refer to the section PRE AUTH > Response > 2. Sample of response (Http POST)