Open Payment API

3.1.1 Request

Method

API Name

URI

POST

AddCard

/opa/AddCard

 

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.

CustName

String

300

M

Merchant’s online buyer name

CustEmail

String

300

M

Merchant’s online buyer email. Require to supply to avoid transaction getting declined.

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=”CustName” value=”Customer Name here”>

<INPUT type=”hidden” name=”CustEmail” value=”abc@gmail.com”>

<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>