Note : Please let us know your server IP list before start integration for whitelisting on our system. Note 2 : Please do not send dummy data for required fields.
Note 3 : The client will be redirect to checkout page which opens in iframe in the browser.

Payment

  • Live URL : https://gateway. /payment/welcome
  • Test URL : https://testgateway. /payment/welcome

HTTP POST FORM

See Form example

Parameters

Parameter Name Detail Example Type Always There
apiKey Your Api Key provided from us. 4d41d21a935f5bba9dee7 c7be4a7ca04 Char 32 ✔
token Code generated 98ca055ed2797f53c5144f4 Char 64 ✔
email Customer email address [email protected] Char 128 ✔
birthday The customer birth date. 1970-01-01 YYYY-MM-DD ✔
amount Amount in cents of the transaction. 1234 for 12.34 € 1550 for 15.50 USD Int ✔
currency The currency of transaction. EUR Char 3 ✔
returnUrl Valid URL where the client is redirected after payment completion. https://www.yourstore.co m/order_confirmation_132 2_ABC Char 256 ✔
referenceNo Your own transaction identifier. 1-1386413490-0089-14 Char 32 ✔
descriptor Statement descriptor Test Char 256
timestamp Unix timestamp 1441190134 Char 32 ✔
language Payment Language Please check Supported languages Char 2
billingTitle Title of the customer. Mr. , Mrs. Char 64
billingFirstName First name of the customer. John Char 64 ✔
billingLastName Last name of the customer. Doe Char 64 ✔
billingCompany The customer company. Test srl. Char 256
billingAddress1 The customer address 1. 26 green street Char 128 ✔
billingAddress2 The customer address 2. 28 red street Char 128
billingCity The customer city. Paris Char 64 ✔
billingPostcode The customer zip code. 75001 Char 16
billingState The customer state. FR Char 2
billingCountry The customer country. FR Char 2 ✔
billingState The customer state. FR Char 2
billingPhone The customer phone number.(Full international number) +905678764567 Char 16 ✔
billingFax The customer fax number. (Full international number) +909990000000 Char 32
paymentMethod Default selected payment method Please check Supported payment methods Char 32 ✔
storeCard Store Card For Next Payment yes/no Char 3
isPreAuth Allow to first authorize a charge on a card yes/no Char 3
sessionId A unique identifier of the user session, for example tracking cookies. DLFJKFU474949H497 Char 255
passwordHash Hash of the user’s password in ASCII encoding (e.g. MD5, SHA-2 family) JKFSDF4573637DHFHFH Char 255
userCreated Date of user first registered to your site in UNIX time format and UTC time zone. 1446370717 (Sun, 01 Nov 2015 09:38:37 +0000) Char 255
walletId A unique identifier of wallet. 11604623c851ff74d060d8f5240056531 Char 255

If you want to send prepopulate creditcard details in the request, you can add the following parameters.

Parameter Name Detail Example Type Always There
number Creditcard number. 4012888888881881 Char 16
expiryMonth Expiry month of creditcard. 09 Int
expiryYear Expiry year of creditcard. 2020 Int
cvv CVV 123 Char 4

Supported Default Payment Method Codes

If you provide one of at the below variable, your customer by pass the payment method select screen

  • CREDITCARD
  • VISA (by Voucher)

Supported Languages

Language Code
English en
French fr
Turkish tr
Chinese cn
German de
Norwegian no
Japanese ja
Polish pl
Russian ru

Generate Token

The parameter “token” is generated with the MD5 (Message Digest Algorithm).

To generate token use the apiKey, amount, currency, referenceNo, timestamp and YOUR_SECRET. The parameters will be combined without any character between them (secretKeyapiKeyamountcurrencyreferenceNotimestamp) YOUR_SECRET is the code generated for each merchant. For example; YOUR_SECRET = t5h2po.

<?php
$apiKey = 'YOUR_API_KEY';
$currency = 'EUR';
$amount = 100;
$referenceNo = uniqid('reference_'); 
$timestamp = time ();
$secretKey = 'YOUR_SECRET_KEY';
$code = '00';
$status = 'APPROVED';

$params =   [
   'apiKey'  =>   $apiKey ,
   'code'  =>   $code ,
   'status'  =>   $status ,
   'amount'  =>  $amount ,
   'currency'  =>   $currency , 
   'referenceNo'  =>   $referenceNo , 
   'timestamp'  =>   $timestamp
];

function generateToken($request, $secretKey) {
    $rawHash = $secretKey . $params['apiKey'] . $params['code'] . $params['status'] . $params['amount'] . $params['currency'] . $params['referenceNo'] . $params['timestamp'];
    return md5( $rawHash );
}

Explanation

Screenshot

Processing Integration Test

Credit Card

  • Which card numbers should I use for testing?
Number Brand Description
4012888888881881 VISA APPROVED
4242424242424242 VISA DECLINED
4900000000000086 VISA NOTENROLLED
5500000000000004 MASTERCARD APPROVED
5200000000000007 MASTERCARD DECLINED
  • For Credit Card testing, you can use any three digit number for CVV and a valid future day for Expration Date.
    • CVV : 123
    • Expiry Date : 10/2025

Redeem Process

Our system automaticlly generates voucher codes at the below payment methods

* Visa
* Gift Card
* Ideal
* China Union Payment

If you are going to use one of these payment you must implement at the below parts. Otherwise, you will not able to receive transaction result.

We are automatically generate a redeem form which is generated in the response parameters. You must base64decode the “ returnForm” and print into your return page.

!! IMPORTANT !!

When the redeem process completed customers will stay at merchants return page which is provided by request parameter (returnUrl)

<?php echo base64_decode($_REQUEST[‘returnForm’]); ?>

Example Integration Form

    <input name="apiKey" value="<?=$apiKey?>" type="text">
    <input name="email" value="[email protected]" type="text">
    <input name="birthday" value="1970-01-01" type="text">
    <input name="amount" value="<?=$amount?>" type="text">
    <input name="currency" value="<?=$currency?>" type="text">
    <input name="returnUrl" value="http://merchantReturnUrl.com" type="text">
    <input name="referenceNo" value="<?=$referenceNo?>" type="text">
    <input name="billingTitle" value="Mr." type="text">
    <input name="billingFirstName" value="John" type="text">
    <input name="billingLastName" value="Doe" type="text">
    <input name="billingAddress1" value="26 green street" type="text">
    <input name="billingAddress2" value="" type="text">
    <input name="billingCity" value="Paris" type="text">
    <input name="billingPostcode" value="75001" type="text">
    <input name="billingState" value="IT" type="text">
    <input name="token" value=" " type="text">
    <input name="timestamp" value="<?=$timestamp?>" type="text">
    <select name="billingCountry">
        <option value="TR">TURKEY</option>
        <option value="IT">ITALY</option>
        <option value="FR" selected>FRANCE</option>
    </select>
    <input name="billingPhone" value="+905678764567" type="text">
    <input name="billingFax" value="" type="text">
    <input name="number" value="4012888888881881" type="text">
    <input name="expiryMonth" value="12" type="text">
    <input name="expiryYear" value="2020" type="text">
    <input name="cvv" value="123" type="text">
    <input value="SEND" type="submit">