Ödeme (iFrame'siz)

i-Frame kullanılmadan doğrudan otorizasyon almak için kullanılan servistir. Bu serviste istek yapabilmesi için token bilgisinin Header'da gönderilmesi gerekmektedir. Bu linkten Üye İşyeri Doğrulama token bilgilerine ulaşabilirsiniz.

Ödeme isteği öncesinde CommissionInquiry servisi ile komisyon tanımı ve bu tanıma ait oran ile hesaplanmış komisyon tutarı bilgisi öğrenilebilir. Ayrıca CampaignInquiry servisi ile kampanya tanımı ve bu tanıma ait oran ile hesaplanmış indirim tutarı bilgisi öğrenilebilir.

Not: Servisten dönen html bilgisini iFrame içerisine basılmak isteniyorsa cors policy'e takılmamak için iframe attribure'larına aşağıdaki alanlar eklenmelidir:

var iframe = document.createElement('iframe');

iframe.setAttribute('sandbox', 'allow-same-origin allow-top-navigation allow-forms allow-scripts');

Servise gönderilmesi gereken parametreler şu şekildedir:

Servisten dönen parametreler şu şekildedir:

İstek başarılıysa okUrl'e başarısızsa failUrl'e Form olarak iletilecektir. Request.Form["alan_adi"] ile dönüş bilgileri çekilebilir

Örnek JSON formatında istek ve cevaplar aşağıdadır:

HTTP Method: POST

Content-Type: application/json

TEST URL: https://ppgpayment-test.birlesikodeme.com:20000/api/ppg/Payment/Payment3d

PROD URL: https://{baseUrl}/api/ppg/Payment/Payment3d

*Prod için baseUrl adresi,size entegrasyon mailinde "paymentBaseUrl" alanında iletilecektir.

Request

{
  "insertCard": true,
  "use3D": true,
  "merchantId": 0,
  "customerId": "string",
  "cardNumber": "string",
  "expiryDateMonth": "string",
  "expiryDateYear": "string",
  "cvv": "string",
  "secureDataId": 0,
  "cardAlias": "string",
  "userCode": "string",
  "txnType": "string",
  "installmentCount": "string",
  "currency": "string",
  "okUrl": "string",
  "failUrl": "string",
  "orderId": "string",
  "totalAmount": "string",
  "pointAmount": "string",
  "rnd": "string",
  "hash": "string",
  "description": "string",
  "requestIp": "string",
  "cardHolderName": "string",
  "extraData": "string",
  "campaign": {
    "text": "string",
    "value": "string"
  },
  "billingInfo": {
    "taxNo": "string",
    "taxOffice": "string",
    "firmName": "string",
    "identityNumber": "string",
    "fullName": "string",
    "email": "string",
    "phone": "string",
    "address": "string",
    "city": "string",
    "town": "string",
    "zipCode": "string"
  },
  "deliveryInfo": {
    "taxNo": "string",
    "taxOffice": "string",
    "firmName": "string",
    "identityNumber": "string",
    "fullName": "string",
    "email": "string",
    "phone": "string",
    "address": "string",
    "city": "string",
    "town": "string",
    "zipCode": "string"
  },
  "orderProductList": [
    {
      "merchantId": 0,
      "productId": "string",
      "amount": "string",
      "productName": "string",
      "commissionRate": "string",
      "description": "string"
    }
  ],
  "maturityPeriod": "string",
  "paymentFrequency": "string"
}

Response

İstek başarılıysa okUrl'e başarısızsa failUrl'e Form olarak iletilecektir. Request.Form["alan_adi"] ile dönüş bilgileri çekilebilir.
<form id="step1Form" runat="server">
<input type="hidden" name="OrderId" value ="10020102">
<input type="hidden" name="Rnd" value ="123456">
<input type="hidden" name="HostReference" value ="123456879">
<input type="hidden" name="AuthCode" value ="123456">
<input type="hidden" name="TotalAmount" value ="1000">
<input type="hidden" name="ResponseHash" value ="77240FF3043CC9837C789F59DBFD999AC5327A82FE7A504F5B50B7B8A60CB9684FCC18F530F90842EE806A62BD65FEB1E31CC59535F055E703A3C47CCEF584BF">
<input type="hidden" name="ResponseCode" value ="00">
<input type="hidden" name="ResponseMessage" value ="İşlem başarılı">
<input type="hidden" name="CustomerId" value ="customer1">
<input type='hidden' name='ExtraData' value=''>
<input type='hidden' name='InstallmentCount' value='2'>

HASH Hesaplama

PHP ile Ödeme Örnek Kod

<?php

$sonuc=$_GET['sonuc'];

if($sonuc=='true' || $sonuc=='false')
{
    echo '<pre>';
    var_dump($_POST);
    echo '</pre>';
}
else
{

$token = ''; // token bilgisini giriniz.
$arParams = array(
   "cardNumber" => "5101385101385104",
   "cvv" => "000",
   "expiryDateYear" => "22",
   "expiryDateMonth" => "12",
   "use3D" => true,
   "memberId" => 1,
   "merchantId" => 1, // size ait merchant id bilgisini giriniz.
   "customerId" => "12345",
   "userCode" => "test",
   "txnType" => "Auth",
   "installmentCount" => "0",
   "okUrl" => "http://localhost/odeme.php?sonuc=true",
   "failUrl" => "http://localhost/odeme.php?sonuc=false",
   "orderId" => "123456abcdefghtr",
   "totalAmount" => "2000",
   "rnd"=> "123456abcde",
   "currency" => "949",
   "requestIp"=>"192.0.0.1",
   "hash" => "" // hash hesapmasını tekrar yapınız.
);

$data_string = json_encode($arParams);
$url = "https://ppgpayment-test.birlesikodeme.com:20000/api/ppg/Payment/Payment3d";

$ch = curl_init($url);   

curl_setopt($ch, CURLOPT_CUSTOMREQUEST , "POST");       
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);      
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 0);
curl_setopt($ch, CURLOPT_FOLLOWLOCATION, 0);                                                                
curl_setopt($ch, CURLOPT_POSTFIELDS, $data_string);                                                                  
curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, 0);
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, 0);
curl_setopt($ch, CURLOPT_HTTPHEADER, array(                                                                          
    'Content-Type:application/json',                                                                                
    'Content-Length: ' . strlen($data_string).'',
    'Authorization: Bearer '.$token     
));     
$result = curl_exec($ch);
$sonuc=htmlspecialchars($result, ENT_QUOTES);
curl_close($ch);

}

?>