Directpay | Docs

# Request

<form method="POST" action="https://testpay.directpay.lk/">
    <label>Type</label>
    <input type="text" name="_type" id="_type" value="CARD_ADD">
    <label>Merchant Id</label>
    <input type="hidden" name="_mId" id="_mId" value="xxxxxxxx">
    <label>First Name</label>
    <input type="text" name="_firstName" id="_firstName" value="john">
    <label>Last name</label>
    <input type="text" name="_lastName" id="_lastName" value="doe">
    <label>Email</label>
    <input type="text" name="_email" id="_email" value="abc@mail.com">
    <label>Reference</label>
    <input type="text" name="_reference" id="_reference" value="ref1234">
    <label>Description</label>
    <input type="text" name="_description" id="_description" value="My Product">
    <label>Return Url</label>
    <input type="hidden" name="_returnUrl" id="_returnUrl" value="https://test.com">
    <label>Cancel Url</label>
    <input type="hidden" name="_cancelUrl" id="_cancelUrl" value="https://test.com">
    <label>Response Url</label>
    <input type="hidden" name="_responseUrl" id="_responseUrl" value="https://test.com">
    <label>Order Id</label>
    <input type="text" name="_orderId" id="_orderId" value="1234">
    <label>Plugin Version</label>
    <input type="hidden" name="_pluginVersion" id="_pluginVersion" value="1.0">
    <label>plugin Name</label>
    <input type="hidden" name="_pluginName" id="_pluginName" value="CUSTOM">
    <label>Api Key</label>
    <input type="hidden" name="api_key" id="api_key" value="12312321">
    <input type="hidden" name="signature" id="signature" value="jb231j3b2jbj2cbjeh">

    <button type="submit" >Add Card</button>
</form>
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33

# Parameter

Field Type Description Allow values
__reference String Id for user identification / Unique value for identify the card holder.

# Response

BrowserRedirectResponse

http://response.com?orderId=DP12355&trnId=-&status=SUCCESS&desc=-&type=CARD_ADD
1

ServerResponse

{
    "type": "CARD_ADD",
    "card": {
        "cardList": [
            {
                "brand": "MASTERCARD",
                "cardId": 1113,
                "expiry": "12-25",
                "id": 1113,
                "issuer": "FISERV SOLUTIONS, LLC",
                "mask": "511111xxxxxx1118",
                "nickName": "Card",
                "reference": "DP123456"
            }
        ],
        "newCard": {
            "brand": "MASTERCARD",
            "cardId": 1113,
            "expiry": "12-25",
            "id": 1113,
            "issuer": "FISERV SOLUTIONS, LLC",
            "mask": "511111xxxxxx1118",
            "nickName": "Card",
            "reference": "DP123456"
        },
        "status": "SUCCESS"
    }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
  • PHP

# Signature generate

<?php
    $dataString = $merchant . $pluginName . $pluginVersion . $returnUrl . $cancelUrl . $orderId . $reference .
                   $firstName . $lastName . $email . $description . $apiKey . $responseUrl;
    $pkeyid = openssl_get_privatekey($pri_key);
    $signResult = openssl_sign($dataString, $signature, $pkeyid, OPENSSL_ALGO_SHA256);
    $signatureEncoded = base64_encode($signature);
?>
1
2
3
4
5
6
7

←