İptal Ve İade Servisi

Başarılı bir işlemin iptal veya iadesini yapmak 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

Servise gönderilmesi gereken parametreler şu şekildedir:

Servisten dönen parametreler şu şekildedir:

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

HTTP Method: POST

Content-Type: application/json

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

*Test ortam için bu adresi kullanabilirsiniz. Prod ortam için size URL bilgisi entegrasyon sürecinde iletilecektir.

Request

{
  "memberId": 0,
  "merchantId": 0,
  "customerId": "string",
  "userCode": "string",
  "txnType": "string",
  "okUrl": "string",
  "failUrl": "string",
  "orderId": "string",
  "totalAmount": "string",
  "rnd": "string",
  "hash": "string",
  "description": "string",
  "requestIp": "string",
  "extraData": "string",
  "orderProductList": [
    {
      "merchantId": 0,
      "productId": "string",
      "amount": "string",
      "productName": "string",
      "commissionRate": "string"
    }
  ]
}

Response

{
  "url": "string",
  "responseCode": "string",
  "responseMessage": "string",
  "orderId": "string",
  "txnType": "string",
  "txnStatus": "string",
  "vposId": 0,
  "vposName": "string"
}

HASH Hesaplama

String CustomerId="123456789"; //müşteri tarafından gönderilecek bilgi
String UserCode="test@test.com"; //API kullanıcısı mail adresi
String HashPassword="7FAD0B3E8E8691C36B26D5BC9D6227A5";
String TxnType="Auth";
String InstallmentCount="0";
String Currency="949";
String OkUrl="http://localhost:61111/ppg/PaycoreResult.aspx";
String FailUrl="http://localhost:61111/ppg/PaycoreResult.aspx";
String OrderId="";
String TotalAmount="125";
String Rnd = DateTime.Now.Ticks.ToString();
String hashString = HashPassword + UserCode +Rnd+ TxnType+ TotalAmount +
CustomerId + OrderId + OkUrl + FailUrl ;
System.Security.Cryptography.SHA512 s512 =
System.Security.Cryptography.SHA512.Create();
System.Text.UnicodeEncoding ByteConverter = new
System.Text.UnicodeEncoding();
byte[] bytes = s512.ComputeHash(ByteConverter.GetBytes(hashString));
String Hash = System.BitConverter.ToString(bytes).Replace("-", "");

C# ile Hesaplama Metodu

public static string CreateHash(VposRequest request)
 {
 var hashString = $"{hashPassword}{request.UserCode}{request.Rnd}{request.TxnType}{request.TotalAmount}{request.CustomerId}{request.OrderId}{request.OkUrl}{request.FailUrl}";
 System.Security.Cryptography.SHA512 s512 =
System.Security.Cryptography.SHA512.Create();
 System.Text.UnicodeEncoding ByteConverter = new
System.Text.UnicodeEncoding();
 byte[] bytes =
s512.ComputeHash(ByteConverter.GetBytes(hashString));
 var hash = System.BitConverter.ToString(bytes).Replace("-",
"");
 return hash;
 }

Java ile Hesaplama Metodu

import java.nio.charset.StandardCharsets;
import java.security.MessageDigest;
import java.security.NoSuchAlgorithmException;
public static String getSecureData(String dataToHash ){

 String generatedHash = null;

 try {

 MessageDigest md = MessageDigest.getInstance("SHA-512");
 byte[] bytes =
md.digest(dataToHash.getBytes(StandardCharsets.UTF_16LE));
 StringBuilder sb = new StringBuilder();
 for(int i=0; i< bytes.length ;i++){
 sb.append(Integer.toString((bytes[i] & 0xff) + 0x100,
16).substring(1));
 }
 generatedHash = sb.toString().toUpperCase();

 } catch (NoSuchAlgorithmException e) {
 e.printStackTrace();
 }
 return generatedHash;
}

PHP ile Hesaplama Metodu

$hash = $hashkey . $userCode . $rnd . $txnType . $totalAmount . $customerId . $order_id . $okUrl . $failUrl;
$hash= mb_convert_encoding($hash, "UTF-16LE");
$hashString = hash("sha512", $hash);