Non-Automatic Order Matching Services

Payguru provides this method for the merchant to transmit the data collected from the customer by manual payment notification. This method is called by merchant to query the Payguru platforms with the parameters collected by the merchant.

Get

Merchant may query the Payguru platform by the Payment Notification Id created by using the information collected from the customer.

>URL

 https://api.payguru.com/phs/paymentNotification/get

>HTTP Method

GET or POST

>Headers

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

>Parameters

Field	Type	Description
id	Integer - Required	Payment Notification ID

>Success

Field	Type	Description
status	String	Status Code: 000
message	String	Message
paymentNotification	Array[]	PaymentNotification Detail
-id	String	ID
-code	String	Code
-bank_id	String	Bank ID
-bank_code	String	Bank Code
-bank_name	String	Bank Name
-merchant	String	Merchant ID
-merchant_name	String	Merchant Name
-service_id	String	Service ID
-service_code	String	Service Code
-service_name	String	Service Name
-transaction_id	String	Transaction ID
-order_refno	String	Order RefNo
-tc_no	String	TCNO
-name	String	Name
-email	String	Email
-phone	String	Phone
-amount	String	Amount
-description	String	Description
-user_ip	String	User IP
-create_time	String	Create Time Format:YYYY-MM-DD HH:II:SS
-apply_time	String	Apply Time Format:YYYY-MM-DD HH:II:SS
-status	String	Payment Notification Status #See

>Error

Field	Type	Description
status	String	Status Code: #See
message	String	Message

{
    "status": "000",
    "message": "Success",
    "paymentNotification": {
        "id": 15,
        "code": "12345678",
        "bank_id": 3,
        "bank_code": "yapikredibank",
        "merchant": 123,
        "merchant_name": "XXXX",
        "service_id": 1,
        "service_name": "XXXXX", 
        "service_code": "xxxxx", 
        "transaction_id": 12345, 
        "order_refno": "123456789", 
        "tc_no": "12345678911", 
        "name": "Hello", 
        "email": "test@payguru.com", 
        "phone": "5123456789", 
        "amount": "2.00",
        "user_ip": "000.000.000.000",
        "create_time": "2017-03-06 17:47:54",
        "apply_time": "2017-02-20 13:41:42",
        "description": "test 123456",
        "status": 10
    }
}

{
    "status": "ERR_005",
    "message": "Invalid Service"
}

>Sample Codes

curl -X GET -H "token: {3E53E639-5173-D1B6-9368-68FCBCF72342}" -H "merchant: 123" --globoff "https://api.payguru.com/phs/paymentNotification/get/12345678"

<?php
$curl = curl_init();
$url = "https://api.payguru.com/phs/paymentNotification/get";
$data = [
    "id"=>"123456789",
];
$headers = [
    "token: {3E53E639-5173-D1B6-9368-68FCBCF72342}",
    "merchant: 123"
];
curl_setopt_array($curl, array(
  CURLOPT_URL => $url."?".http_build_query($data),
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => $headers,
));
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

var client = new RestClient("https://api.payguru.com/phs/paymentNotification/get?id=12345678");
var request = new RestRequest(Method.GET);
request.AddHeader("merchant", "123");
request.AddHeader("token", "{3E53E639-5173-D1B6-9368-68FCBCF72342}");
IRestResponse response = client.Execute(request);
var o = JObject.Parse(response);
if (o["status"] == "000") {
    MessageBox.Show((string)o["paymentNotification"]["id"]);
} else {
    MessageBox.Show((string)o["message"]);
}

import requests,json
url = "https://api.payguru.com/phs/paymentNotification/create"
querystring = {"id":"12345678"}
headers = {
    "token": "{3E53E639-5173-D1B6-9368-68FCBCF72342}",
    "merchant": "123"
}
response = requests.request("GET", url, headers=headers, params=querystring)
if response.status_code == 200:
    o = json.loads(response.text)
    if o["status"] == "000":
        print o["paymentNotification"]["code"]
    else:
        print o["message"]
else:
    print "Request Error"

Create

It is the service that starts manual payment notification process with the information collected from the customer about the payment. The service is always triggered by the merchant.

>URL

 https://api.payguru.com/phs/paymentNotification/create

>HTTP Method

GET or POST

>Headers

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

>Parameters

Field	Type	Description
code	String - Required	Service Code
amount	String - Required	Amount
bank	String - Required	Bank Code
order	String - Required	Merchant Order
PaymentNotification	Array[]	PaymentNotification Fields
-tc_no	String	TCKN
-name	String	Name
-email	String	Email
-phone	String	Mobile Phone
-user_ip	String	User IP
-apply_time	Date	Apply Time Format:YYYY-MM-DD HH:II:SS
-description	String	Description

>Success

Field	Type	Description
status	String	Status Code: 000
message	String	Message
code	String	PaymentNotification Code

Please forward to "https://cp.payguru.com/phs/yonlendir/{CODE}?redirect=SUCCESS_URL&backUrl=BACK_URL" with the code in response.
Redirect parameters are optional

>Error

Field	Type	Description
status	String	Status Code: #See
message	String	Message

>Response Examples

Success
Error

{
    "status": "000",
    "message": "Success",
    "code": "1234567890"
}

{
    "status": "ERR_005",
    "message": "Invalid Service"
}

>Sample Codes

curl -X GET -H "token: {3E53E639-5173-D1B6-9368-68FCBCF72342}" -H "merchant: 123" --globoff "https://api.payguru.com/phs/paymentNotification/create?amount=123.12&bank=000&order=XXXXXXX&code=XXX&PaymentNotification[name]=Hello&PaymentNotification[tc]=123456789"

<?php
$curl = curl_init();
$url = "https://api.payguru.com/phs/paymentNotification/create";
$id = "72824979";
$data = [
    "amount" => "123.12",
    "bank" => "000",
    "order" => "XXXXXXX",
    "code" => "XXX",
    "PaymentNotification" => [
        "name" => "Hello",
        "tc" => 123456789,
    ]
];
$headers = [
    "token: {3E53E639-5173-D1B6-9368-68FCBCF72342}",
    "merchant: 123"
];
curl_setopt_array($curl, array(
  CURLOPT_URL => $url."?".http_build_query($data),
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => $headers,
));
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
  echo "cURL Error #:" . $err;
} else {
  $o = json_decode($response,true);
  if($o["status"] == "000"){
      echo $o["code"];
  }else{
      echo $o["message"];
  }
}

var client = new RestClient("https://api.payguru.com/phs/paymentNotification/create
                    ?amount=123.12&bank=000&order=XXXXXXX&code=XXX&PaymentNotification%5Bname%5D=Hello&PaymentNotification%5Btc%5D=123456789");
var request = new RestRequest(Method.GET);
request.AddHeader("merchant", "123");
request.AddHeader("token", "{3E53E639-5173-D1B6-9368-68FCBCF72342}");
IRestResponse response = client.Execute(request);
var o = JObject.Parse(response);
if (o["status"] == "000") {
    MessageBox.Show((string)o["code"]);
} else {
    MessageBox.Show((string)o["message"]);
}

import requests,json
url = "https://api.payguru.com/phs/paymentNotification/create"
querystring = {"amount":"123.12","bank":"000","order":"XXXXXXX","code":"XXX","PaymentNotification[name]":"Hello","PaymentNotification[tc]":"123456789"}
headers = {
    "token": "{3E53E639-5173-D1B6-9368-68FCBCF72342}",
    "merchant": "123"
}
response = requests.request("GET", url, headers=headers, params=querystring)
if response.status_code == 200:
    o = json.loads(response.text)
    if o["status"] == "000":
        print o["code"]
    else:
        print o["message"]
else:
    print "Request Error"