Method | API Name | URI |
POST | PreAuth | /opa/PreAuth |
Field Name | Data Type | Size | M/O | Description & Remarks |
MerchantNo | String | 16 | M | Merchant number assigned by the system |
ReqDate | String | 14 | M | Client request date when calling the API. Format: yyyyMMddHHmmss. A time 60 minutes earlier or later than host system time will be rejected. |
RequestId | String | 50 | M | Request Id to identify request from merchant |
CustId | String | 50 | M | Merchant’s customer id. |
OrderId | String | 50 | M | Order Id. |
CardTokenId | String | 20 | M | Card Token Id |
Amount | String | 10 | M | Pre-Authorization amount. Up to 2 decimals and no thousand separators. Example: “10”, “10.5”, “10.50”.
For bidding / auction application, it should be the full amount of first bid price. And for the subsequent bid of same bidder, it should be the incremental bid price.
Example: i. 1st bid: RM500: Amount = RM500. ii. 2nd bid: RM600: Amount = RM600 – RM500 = RM100. |
ReturnUrl | String | 300 | M | Realtime web browser or frontend direction endpoint for hosted page. |
Signature
| String | – | M | Calculated hash by concatenating all the values of the fields and follow the list order. |
Legend:
M: Mandatory field
C: Conditional field
O: Optional field, value can be empty but parameter must exist
Example
<HTML> <BODY> <FORM method=”post” action=”[Base URL]/opa/AddCard”> <INPUT type=”hidden ” name=”MerchantNo” value=”1000000000000001″> <INPUT type=”hidden” name=”ReqDate” value=”20210101153020″> <INPUT type=”hidden” name=” RequestId ” value=”2022033001ABC”> <INPUT type=”hidden” name=”CustId” value=”1993023323″> <INPUT type=”hidden” name=”OrderId” value=” OrderId123456789”> <INPUT type=”hidden” name=”CardTokenId” value=”21011505052620000001”> <INPUT type=”hidden” name=”Amount” value=”500”> <INPUT type=”hidden” name=”ReturnUrl” value=”https://www.example.com/xxx”> <INPUT type=”hidden” name=”Signature” value=”[Calculated hash]” <INPUT type=”submit” value=”Submit” name=”Submit”> </FORM> </BODY> </HTML> |
