Notifications

Payguru Nakit Ödeme ve Banka Transfer hizmeti ile Payguru platformuna kabul edilen ödemelerin üye işyerine bildirimini sağlayan temel web hizmetleridir . Üye işyeri kendisine ait ödemeler ile ilgili tüm bilgilendirmeleri bu hizmetler üzerinden alır. Hizmetlerin bildirim yapacağı söz konusu URL entegrasyon sürecinde üye iş yeri tarafından Payguru'ya bildirilir.

>URL

 http://yoursite.com/PhsNotifyService

>HTTP Method

GET yada POST/JSON

If request true then only give response "OK".

Notify Key: md5( Service code + Merchant ID + Transaction ID + Transaction Code + Order RefNo + Amount + Merchant Private Key + Service Private Key)

>Parameters

Field	Type	Description
txid	Integer - Required	Transaction ID
code	String - Required	Payguru Order
order	String - Required	Merchant Order
status	Integer - Required	Transaction Status #See Transaction Status
amount	Float - Required	Transaction Amount
transaction_date	Date - Required	Transaction Time
bank	String - Required	Bank Code
key	String - Required	Notify Key #See Notify Key

GET

>Örnek Kodlar

<?
$data = $_GET;
//$data["txid"] = Transaction ID
//$data["code"] = Transaction Code
//$data["order"] = Order Refno
//$data["status"] = Transaction Status
//$data["amount"] = Transaction amount
//$data["transaction_date"] = Transaction Date
//$data["bank"] = Bank Code
//$data["key"] = Notify Key
$localKey = md5("Service Code"."Merchant ID".$data["txid"].$data["code"].$data["order"].$data["amount"]."Merchant Private Key"."Service Private Key");
if($localKey = $data["key"] && $data["status"] == "3"){
     echo "OK";//If you accept this request, you must response with "OK"
//find transaction with order
}else{
    echo "Wrong Data";
}

POST/JSON

>Örnek Kodlar

<?
$data = json_decode(file_get_contents("php://input"),true);
//$data["txid"] = Transaction ID
//$data["code"] = Transaction Code
//$data["order"] = Order Refno
//$data["status"] = Transaction Status
//$data["amount"] = Transaction amount
//$data["transaction_date"] = Transaction Date
//$data["bank"] = Bank Code
//$data["key"] = Notify Key
$localKey = md5("XXX".123.$data["txid"].$data["code"].$data["order"].$data["amount"]."Merchant Key + Service Key");
if($localKey = $data["key"] && $data["status"] == "3"){
     echo "OK";//If you accept this request, you must response with "OK"
//find transaction with order
}else{
echo "Wrong Data";
}

TCKN Verify Service

>URL

 http://yoursite.com/TCKNVerifyService

>HTTP Method

GET or POST/JSON

>Response

JSON => {status:true,tckn:md5(TCKN + ServicePrivateKey)}

TCKN Verification Notify Key: md5( Service code + Merchant ID + Order RefNo + Merchant Private Key + Service Private Key)

>Parameters

Field	Type	Description
txid	Integer	Transaction ID
code	String	Payguru Order
order	String	Merchant Order
amount	Float	Transaction Amount
transaction_date	Date	Transaction Time
bank	String	Bank Code
bank_no	String	Bank No
key	String	Notify Key #See TCKN Verification Notify Key

GET

>Sample Codes

<?
$data = $_GET;
//$data["txid"] = Transaction ID
//$data["code"] = Transaction Code
//$data["order"] = Order Refno
//$data["amount"] = Transaction amount
//$data["transaction_date"] = Transaction Date
//$data["bank"] = Bank Code
//$data["bank_no"] = Bank ID
//$data["key"] = Notify Key
$localKey = md5("Service Code" . "Merchant ID" . $data["order"] . "Merchant Key" . "Service Key");
if ($localKey = $data["key"]) {
    //$relevantTckn="";
    $responseArr = array("status" => true, "tckn" => md5($relevantTckn . "Service Key"));
} else {
    $responseArr = array("status" => false, "tckn" => null);
}
echo json_encode($responseArr);

POST/JSON

>Sample Request


<?
$data = json_decode(file_get_contents("php://input"), true);
//$data["txid"] = Transaction ID
//$data["code"] = Transaction Code
//$data["order"] = Order Refno
//$data["amount"] = Transaction amount
//$data["transaction_date"] = Transaction Date
//$data["bank"] = Bank Code
//$data["bank_no"] = Bank ID
//$data["key"] = Notify Key
$localKey = md5("Service Code" . "Merchant ID" . $data["order"] . "Merchant Key" . "Service Key");
if ($localKey = $data["key"]) {
    //$relevantTckn="";
    $responseArr = array("status" => true, "tckn" => md5($relevantTckn . "Service Key"));
} else {
    $responseArr = array("status" => false, "tckn" => null);
}
echo json_encode($responseArr);

Test Transaction

You can try this method for testing a transaction. You receives a notification. It only works on sandbox mod.

>URL

 https://sandbox.payguru.com/phs/transaction/test

>HTTP Method

GET yada POST

>Headers

Field	Type	Description
merchant	Integer - Required	Merchant ID
token	String - Required	Token

>Parameters

Field	Type	Description
code	String - Required	Service Code
ref	String - Required	Payguru Reference Code(You can get orderLookup/Check)
amount	Amount - Required	Amount of Transaction
name	String - Optional	User name
description	String - Optional	Description of Transaction
iban	String - Optional	IBAN
tckno	Numeric - Optional	T.C No

>Success

Gives Your Response