درگاه اینترنتی

آموزش ویدئویی اتصال به درگاه اینترنتی : https://paystar.ir/help

مقدمه

این مستند جهت ارائه به پذیرندگان پی استار جهت اتصال به درگاه پرداخت میباشد. در حالت کلی پذیرنده ابتدا میبایست یک درخواست ایجاد تراکنش ارسال و برای آغاز تراکنش یک توکن یکبار مصرف دریافت و آن را برای انجام تراکنش به سایت پست نماید. بعد از بازگشت مشتری از درگاه، اطلاعات وضعيت تراکنش به سمت پذیرنده برگشت داده میشود و پذیرنده پس از دریافت اطلاعات میبایست نسبت به verify کردن تراکنش اقدام نماید.

نکته 1 : سرویسها به صورت REST با متد POST و فرمت json قابل استفاده میباشد.

نکته 2: :آدرس پایه برای اتصال به تمامی وبسرویسها https://core.paystar.ir/api/pardakht میباشد. این آدرس را به ابتدای آدرس های نسبی معرفی شده در مستند بيافزایيد. به عنوان مثال آدرس وبسریس create به شکل زیر تبدیل میشود.

• https://core.paystar.ir/api/pardakht/create

سرویس Create

این سرویس جهت ایجاد تراکنش به کار میرود و پذیرنده با دادن اطلاعات مورد نياز ایجاد تراکنش یک توکن یکبار مصرف دریافت میکند

key	value
Content-Type	application/json
Authorization	Bearer <YOUR_GATEWAY_ID>

توجه: به جای <YOUR_GATEWAY_ID> مقدار شناسه درگاه خود که در پنل پی استار وجود دارد را قرار دهيد.

پارامترهای ورودی

نام فیلد	نوع داده	شرح	اجباری
amount	double	مبلغ تراکنش	بله
order_id	string	شناسه سفارس	بله
callback	string	آدرس برگشت	بله
sign	string	امضاء	بله
name	string	نام پرداخت کننده	خیر
phone	string	تلفن پرداخت کننده	خیر
mail	string	ایمیل پرداخت کننده	خیر
description	string	توضیحات پرداخت	خیر
allotment	array	تسهیم در هر تراکنش	خیر
callback_method	integer	متد انتخابی برای بازگشت کاربر به سایت پذیرنده	خیر
wallet_hashid	string	شناسه کیف پول	خیر
national_code	string	کد ملی پرداخت کننده	خیر
card_number	string	شماره کارت پرداخت کننده	خیر

توجه:

• مبلغ تراکنش میبایست به ریال باشد و حداقل 5,000 ریال و حداکثر 500,000,000 ریال است. همچنين با توجه به تنظيمات کارمزد پایانه، سهم کارمزد پرداخت کننده به مبلغ افزوده خواهد شد.

• یکتایی شناسه سفارش در سامانه بررسی نمیشود. بهتر است به منظور جلوگيری از بروز خطا از شناسه یکتا استفاده شود. طول شناسه سفارش حداقل 1 و حداکثر 50 کاراکتر و شامل حروف و اعداد میباشد.

• آدرس برگشت باید با فرمت https://yoursite.ir/your/callback/url باشد. دامنه برگشت، باید دامنه اصلی سامانه که در هنگام ایجاد درگاه ثبت کرده اید باشد.

• شناسه کيف پول باید متعلق به کاربر دارنده درگاه باشد. بدیهی است که وضعيت کيف باید فعال باشد.

• چنانچه در نظر دارید پرداخت مورد نظر فقط از طریق یک شماره کارت مشخص انجام شود، در فیلد card_number، شماره کارت مربوطه را ارسال نمایید.

• قابليت محدودیت شماره کارت پرداخت کننده در حال حاضر تنها بر روی درگاه های پی اس پی سامان کيش اعمال ميشود. بنابراین جهت استفاده از این قابليت ميبایست با بخش فروش پی استار هماهنگی های لازم انجام گيرد.

• چنانچه فیلد کد ملی (national_code) ارسال گردد، پرداخت تنها از طریق شماره کارتهایی که متعلق به کد ملی پرداخت کننده باشند امکان پذیر خواهد بود.

• برای ساخت امضا از متد HMAC و الگوریتم رمزنگاری SHA512 استفاده کنيد. کليد مورد نياز برای رمزنگاری، در هنگام ساخت درگاه در اختيار شما قرار میگيرد. آماده سازی داده ها برای امضا به صورت زیر میباشد:

amount#order_id#callback

پارامتر های خروجی (درصورت مجاز بودن درگاه برای تراکنش)

عنوان	نوع داده	شرح
status	int	جدول وضعيت
message	string	پيام سيستم
data	PardakhtCreateData	جدول نوع داده PardakhtCreateData

نمونه کد (php) :

<?php

$url = 'https://core.paystar.ir/api/pardakht/create';

$gateway_id = 'your_gateway_id';

$amount = 10000.0;

$order_id = '45245';

$callback = 'https://example.com/callback';

$sign_key = 'your_sign_key';

$sign_data = $amount. '#'. $order_id . '#'. $callback;

$sign = hash_hmac('SHA512', $sign_data, $sign_key);

$body_params = [

'amount' => $amount,

'order_id' => '45245',

'callback' => $callback,

'sign' => $sign,

'name' => 'علی مرادی',

'phone' => '09121234567',

'mail' => 'john@example.com',

'description' => 'توضیحات تراکنش',

'wallet_hashid' => 'wallet123',

'national_code' => '0234567891',

'card_number' => '1234567890123456'

];

$body_params_json= json_encode($body_params);

$curl = curl_init();

curl_setopt_array($curl, [

CURLOPT_URL => $url,

CURLOPT_RETURNTRANSFER => true,

CURLOPT_POST => true,

CURLOPT_POSTFIELDS => $body_params_json,

CURLOPT_HTTPHEADER => [

'Accept: application/json',

'Content-Type: application/json',

'Authorization: Bearer ' . $gateway_id,

],

]

);

$response = curl_exec($curl);

curl_close($curl);

print_r(json_decode($response ,true ,JSON_PRETTY_PRINT));

نمونه کد (C# .net) :

using System.Security.Cryptography;

using System.Text;

using RestSharp;

using Newtonsoft.Json;

var options = new RestClientOptions("https://core.paystar.ir");

var client = new RestClient(options);

string gateway_id = "your-gateway-id";

string signKey = "your_sign_key";

double amount = 10000.0;

string orderId = "14523";

string callback = "https://example.com/callback";

string signData = amount + "#" + orderId + "#" + callback;

byte[] keyBytes = Encoding.UTF8.GetBytes(signKey);

byte[] dataBytes = Encoding.UTF8.GetBytes(signData);

string sign;

using (HMACSHA512 hmac = new HMACSHA512(keyBytes))

{

byte[] hashBytes = hmac.ComputeHash(dataBytes);

sign = BitConverter.ToString(hashBytes).Replace("-", "").ToLower();

}

var requestBody = new

{

amount = amount,

order_id = orderId,

callback = "https://example.com/callback",

sign = sign,

name = "علی مرادی",

phone = "09234567890",

mail = "john@example.com",

description = "توضیحات تراکنش ",

wallet_hashid = "w12sa3",

national_code = "0234567891",

card_number = "1234567890123456"

};

string jsonBody = JsonConvert.SerializeObject(requestBody);

var request = new RestRequest("/api/pardakht/create", Method.Post);

request.AddJsonBody(jsonBody);

request.AddHeader("Authorization", "Bearer " + gateway_id);

request.AddHeader("Content-Type", "application/json");

RestResponse response = client.Execute(request);

var res = response.Content;

نمونه کد (Python) :

import json

import requests

import hashlib

import hmac

url = "https://core.paystar.ir/api/pardakht/create"

gateway_id = 'your_gateway_id'

header = {

"Accept": "application/json",

"Authorization" : "Bearer " + gateway_id

}

sign_key = 'your_sign_key'

amount = 10000.0

order_id = '45245'

callback = 'https://example.com/callback'

sign_data = f"{amount}#{order_id}#{callback}"

sign = hmac.new(sign_key.encode(), sign_data.encode(), hashlib.sha512).hexdigest()

data = {

'amount': amount,

'order_id': order_id,

'callback': 'https://example.com/callback',

'sign': sign,

'name': 'علی مرادی',

'phone': '09345678910',

'mail': 'john@example.com',

'description': 'توضیحات تراکنش ',

'wallet_hashid': 'wallet123',

'national_code': '0234567891',

'card_number': '1234567890123456'

}

response = requests.post(url, headers=header, json=data)

output = json.dumps(response.json(), indent=4, ensure_ascii=False)

print(output)

پارامتر های خروجی (درصورت غیر مجاز بودن درگاه برای تراکنش)

عنوان	نوع داده	شرح
status	string	مقدار ثابت unauthenticated
action	string	مقدار ثابت PardakhtCreate
tag	string	مقدار ثابت unauthenticated
message	string	پیام سیستم
data	array	آرایه خالی
api_version	string	نسخه API

جدول نوع داده PardakhtCreateData

عنوان	نوع داده	شرح
token	string	توکن یکبار مصرف تراکنش
ref_num	string	شناسه یکتای رهگيری تراکنش
order_id	string	شناسه سفارش
payment_amount	double	مبلغ نهایی پرداختی کاربر با اعمال کارمزد

توجه:

• مقدار ref_num را در دیتابيس ذخيره کنيد. از این شناسه در وبسرویس تایيد تراکنش استفاده خواهد شد.

• در صورت دریافت کد وضعیت -1 ،میبایست خطاهای برگشتی در فیلد data را مورد بررسی قرار داده و با اصلاح پارامترهای ورودی مجددا سرویس را فراخوانی نمایید.

پارامترهای تبادلی میان سایت فروشنده و سامانه پی استار

درصورتی که پاسخ دریافتی از وبسرویس مرحله قبل (ایجاد تراکنش) موفق باشد و توکن یکبار مصرف را دریافت کرده باشيد، میتوانيد مشتری را با توکن دریافتی به سمت پی استار به آدرس زیر هدایت کنيد

• https://core.paystar.ir/api/pardakht/payment

پارامترهای ورودی

نام فیلد	نوع داده	شرح	اجباری
token	string	توکن دریافتی از وبسرویس create	بله

توجه:

• برای هدایت کاربر به این صفحه میتوانید از متد GET یا POST استفاده کنید.

برگشت از درگاه به سایت پذیرنده

پس از انجام تراکنش، کاربر به صفحه CallBack پذیرنده که در زمان ایجاد تراکنش مشخص شده، با ارسال فيلدهای زیر به صورت form-data هدایت خواهد شد. اگر در هنگام فراخوانی وبسرویس create ،پارامتر callback_method با مقدار عددی 1 ارسال شود، بازگشت به سایت پذیرنده با متد GET انجام میشود. در غیر اینصورت بازگشت به سایت پذیرنده با متد POST خواهد بود. بنابراین میبایست متد CallBack خود را با در نظر گرفتن این شرایط پیاده سازی و در وبسایت یا نرم افزار خود قرار دهید.

پارامترهای خروجی

عنوان	نوع داده	شرح
status	int	جدول وضعیت
order_id	string	شناسه سفارش (ارسال شده توسط پذیرنده)
ref_num	string	شناسه یکتای رهگیری تراکنش
transaction_id	string	شناسه تراکنش (موجود در پنل پی استار)
card_number	string	شماره کارت پرداخت کننده
hashed_card_number	string	شماره کارت پرداخت کننده به صورت هش شده
tracking_code	string	کد رهگیری بانکی

توجه:

• درصورتی که وضعيت تراکنش ناموفق باشد ( پرداخت انجام نشده باشد ) فيلدهای card_number , hashed_card_number و tracking_code برگشت داده نمیشود.

سرویس verify

• https://core.paystar.ir/api/pardakht/verify

پذیرنده بعد از گرفتن دادههای برگشتی از درگاه، درصورت موفق بودن تراکنش، از این سرویس جهت تایيدیه تراکنش ارسالی استفاده میکند. نکته مهم این است که پذیرنده نباید تا زمان دریافت وضعيت موفق از این سرویس، تراکنش را موفق در نظر بگيرد. درصورتی که تا 10 دقيقه بعد از تراکنش، این وبسرویس فراخوانی نشود، وضعيت تراکنش به صورت خودکار به ناموفق تغيير ميکند و مبلغ کسر شده از حساب مشتری طی 72 ساعت به حساب مشتری برگشت داده میشود. توجه داشته باشيد در صورتی که یکبار از این وبسریس پاسخ موفق دریافت کنيد، دیگر امکان فراخوانی وبسرویس را نخواهيد داشت و در صورت فراخوانی با پيام خطا مواجه خواهيد شد.

توجه:

به منظور جلوگیری از رخداد خطای timeout و ایجاد مغایرت احتمالی، در هنگام فراخوانی سرویس وریفای، حتما زمان دریافت پاسخ را در هدر درخواست، با یک زمان مناسب (حداقل 10ثانیه) تنظیم نمایید

Header درخواست

key	value
Content-Type	application/json
Authorization	Bearer <YOUR_GATEWAY_ID>

توجه:

• به جای <YOUR_GATEWAY_ID> مقدار شناسه درگاه خود که در پنل پی استار وجود دارد را قرار دهيد.

پارامترهای ورودی

نام فیلد	نوع داده	شرح	اجباری
ref_num	string	شناسه یکتای رهگیری تراکنش	بله
amount	double	مبلغ تراکنش	بله
sign	string	امضاء	بله

توجه:

• برای ساخت امضا از متد HMAC و الگوریتم رمزنگاری SHA512 استفاده کنيد. کليد مورد نياز برای رمزنگاری، در هنگام ساخت درگاه در اختيار شما قرار میگيرد. آماده سازی دادهها برای امضا به صورت زیر میباشد:

amount#ref_num#card_number#tracking_code

پارامترهای خروجی (درصورت مجاز بودن درگاه)

عنوان	نوع داده	شرح
status	int	جدول وضعیت
message	string	پیام سیستم
data	PardakhtVerifyData	جدول نوع داده PardakhtVerifyData

نمونه کد (php) :

<?php

$url = 'https://core.paystar.ir/api/pardakht/verify';

$gateway_id = 'your_gateway_id';

$amount = 10000.0;

$ref_num = '45245';

$tracking_code= 'your_tracking_code';

$card_number = 'your_card_number';

$sign_key = 'your_sign_key';

$sign_data = $amount. '#'. $ref_num . '#' . $card_number . '#'. $tracking_code;

$sign = hash_hmac('SHA512', $sign_data, $sign_key);

$body_params = [

'amount' => $amount,

'ref_num' => $ref_num,

'sign' => $sign,

];

$body_params_json= json_encode($body_params);

$curl = curl_init();

curl_setopt_array($curl, [

CURLOPT_URL => $url,

CURLOPT_RETURNTRANSFER => true,

CURLOPT_POST => true,

CURLOPT_POSTFIELDS => $body_params_json,

CURLOPT_HTTPHEADER => [

'Accept: application/json',

'Content-Type: application/json',

'Authorization: Bearer ' . $gateway_id,

],

]

);

$response = curl_exec($curl);

curl_close($curl);

print_r(json_decode($response ,true ,JSON_PRETTY_PRINT));

نمونه کد (C# .net) :

using System.Security.Cryptography;

using System.Text;

using RestSharp;

using Newtonsoft.Json;

var options = new RestClientOptions("https://core.paystar.ir");

var client = new RestClient(options);

string gateway_id = "your-gateway-id";

string signKey = "your_sign_key";

double amount = 10000.0;

string ref_num = "14523";

string card_number = "your_card_number";

string tracking_code = "your_tracking_code";

string signData = amount + "#" + ref_num + "#" + card_number + "#" + tracking_code;

byte[] keyBytes = Encoding.UTF8.GetBytes(signKey);

byte[] dataBytes = Encoding.UTF8.GetBytes(signData);

string sign;

using (HMACSHA512 hmac = new HMACSHA512(keyBytes))

{

byte[] hashBytes = hmac.ComputeHash(dataBytes);

sign = BitConverter.ToString(hashBytes).Replace("-", "").ToLower();

}

var requestBody = new

{

amount = amount,

ref_num = ref_num,

sign = sign,

};

string jsonBody = JsonConvert.SerializeObject(requestBody);

var request = new RestRequest("/api/pardakht/verify", Method.Post);

request.AddJsonBody(jsonBody);

request.AddHeader("Authorization", "Bearer " + gateway_id);

request.AddHeader("Content-Type", "application/json");

RestResponse response = client.Execute(request);

var res = response.Content;

نمونه کد (Python) :

import json

import requests

import hashlib

import hmac

url = "https://core.paystar.ir/api/pardakht/verify"

gateway_id = 'your_gateway_id'

header = {

"Accept": "application/json",

"Authorization" : "Bearer " + gateway_id

}

sign_key = 'your_sign_key'

amount = 10000.0

ref_num = 'your_ref_num'

card_number = 'your_card_number'

tracking_code = 'your_tracking_code'

sign_data = f"{amount}#{ref_num}#{card_number}#{tracking_code}"

sign = hmac.new(sign_key.encode(), sign_data.encode(), hashlib.sha512).hexdigest()

data = {

'amount': amount,

'ref_num': ref_num,

'sign': sign,

}

response = requests.post(url, headers=header, json=data)

output = json.dumps(response.json(), indent=4, ensure_ascii=False)

print(output)

پارامترهای خروجی (درصورت غیر مجاز بودن درگاه)

عنوان	نوع داده	شرح
status	string	مقدار ثابت unauthenticated
action	string	مقدار ثابت PardakhtCreate
tag	string	مقدار ثابت unauthenticated
message	string	پیام سیستم
data	array	_
api_version	string	نسخه API

جدول نوع داده PardakhtVerifyData

عنوان	نوع داده	شرح
price	double	مبلغ تراکنش
ref_num	string	شناسه یکتای رهگيری تراکنش
card_number	string	شماره کارت پرداخت کننده

تسهیم در تراکنش

علاوه بر تسهیم ایستا که برای همه ی تراکنشها به صورت یکسان اعمال میگردد و از طریق پنل کاربری قابل تنظیم است، میتوان برای هر تراکنش تسهیم متفاوت ایجاد کرد. برای این منظور باید در هنگام فراخوانی سرویس create فیلد allotment را که به فرمت زیر است، در بدنه درخواست ارسال کنید.

جدول نوع داده allotment

عنوان	نوع داده	شرح
id	string	شناسه شریک تجاری
sheba_id	string	شناسه شماره شبا شریک تجاری
share	integer	درصد تسهیم )اجباری در صورت نبود amount
amount	integer	مبلغ تسهیم )اجباری در صورت نبود share)

به عنوان مثال:

"allotment": [

{

"id": "شناسه شریک تجاری اول",

"id_sheba" : "شناسه شبای شریک",

"share": 40

},

{

"id": "شناسه شریک تجاری دوم",

"id_sheba" : "شناسه شبای شریک",

"amount": 10000

}

]

برای تعیین درصد از share و برای تعیین مبلغ از amount استفاده کنید. ارسال همزمان share و amount مجاز نیست. در هر تراکنش، حداکثر هشت رکورد تسهیم قابل ارسال است. بدیهی است که شریک تجاری باید پیشتر از طریق پنل کاربری، ایجاد شده و به درگاه متصل شده باشد. در صورت تسهیم روی تراکنش، تسهیم ایستا روی تراکنش اعمال نمیگردد.

سرویس inquiry

• https://core.paystar.ir/api/pardakht/inquiry

این وبسرویس در مراحل مختلف انجام تراکنش و پس ازآن در دفعات متعدد قابل فراخوانی میباشد.

توجه:

به منظور جلوگيری از رخداد خطای timeout و ایجادمغایرت احتمالی،در هنگام فراخوانی سرویس inquiry، حتما زمان دریافت پاسخ را در هدر درخواست، بایک زمان مناسب (حداقل 10 ثانيه) تنظيم نمایيد.

Header درخواست

key	value
Content-Type	application/json
Authorization	Bearer <YOUR_GATEWAY_ID>

توجه:

• به جای <YOUR_GATEWAY_ID> مقدار شناسه درگاه خود که در پنل پی استار وجود دارد را قرار دهيد.

پارامترهای ورودی

شرح	نوع داده	نوع فیلد	اجباری
ref_num	string	شناسه یکتای تراکنش	بله

پارامترهای خرجی

عنوان	نوع داده	شرح
status	int	جدول وضعيت
message	string	پيام سيستم
data	PardakhtInquiryData	جدول نوع داده PardakhtInquiryData

نمونه کد (php) :

<?php

$url = 'https://core.paystar.ir/api/pardakht/inquiry';

$gateway_id = 'your_gateway_id';

$body_params = [

'ref_num' => '45245',

];

$body_params_json= json_encode($body_params);

$curl = curl_init();

curl_setopt_array($curl, [

CURLOPT_URL => $url,

CURLOPT_RETURNTRANSFER => true,

CURLOPT_POST => true,

CURLOPT_POSTFIELDS => $body_params_json,

CURLOPT_TIMEOUT => 10,

CURLOPT_HTTPHEADER => [

'Accept: application/json',

'Content-Type: application/json',

'Authorization: Bearer ' . $gateway_id,

],

]

);

$response = curl_exec($curl);

curl_close($curl);

print_r(json_decode($response ,true ,JSON_PRETTY_PRINT));

نمونه کد (C# .net) :

using RestSharp;

using Newtonsoft.Json;

var options = new RestClientOptions("https://core.paystar.ir"){ MaxTimeout = 10000 };

var client = new RestClient(options);

string gateway_id = "your-gateway-id";

string ref_num = "14523";

var requestBody = new

{

ref_num = ref_num,

};

string jsonBody = JsonConvert.SerializeObject(requestBody);

var request = new RestRequest("/api/pardakht/inquiry", Method.Post);

request.AddJsonBody(jsonBody);

request.AddHeader("Authorization", "Bearer " + gateway_id);

request.AddHeader("Content-Type", "application/json");

RestResponse response = client.Execute(request);

var res = response.Content;

نمونه کد (Python) :

import json

import requests

url = "https://core.paystar.ir/api/pardakht/inquiry"

gateway_id = 'your_gateway_id'

header = {

"Accept": "application/json",

"Authorization" : "Bearer " + gateway_id

}

ref_num = 'your_ref_num'

data = {

'ref_num': ref_num,

}

response = requests.post(url, headers=header, json=data, timeout=10)

output = json.dumps(response.json(), indent=4, ensure_ascii=False)

print(output)

پارامترهای خروجی (درصورت غیرمجاز بودن درگاه)

عنوان	نوع داده	شرح
status	string	مقدار ثابت unauthenticated
action	string	مقدار ثابت PardakhtInquiry
tag	string	مقدار ثابت unauthenticated
message	string	پيام سيستم
data	string	-
api_version	string	نسخه API

جدول نوع داده PardakhtInquiryData

عنوان	نوع داده	شرح
ref_num	string	شناسه یکتای رهگيری تراکنش
status	string	وضعيت تراکنش (با مقادیر موجود در جدول وضعيت تراکنش)
message	string	پيغام متناسب با وضعيت تراکنش
payment_date	string	تاریخ پرداخت
payment_amount	int	مبلغ پرداختی (ریال)
order_id	string	شناسه سفارش
ref_id	string	شناسه ارجاع
tracking_code	string	کد ارجاع بانکی
card_number	string	شماره کارت پرداخت کننده
hashed_card_number	string	هش شماره کارت پرداخت کننده

جدول وضعیت تراکنش

وضعیت	شرح
INIT	تراکنش در انتظار پرداخت است
SUCCEED	پرداخت با موفقيت انجام شد
FAILED	عمليات پرداخت با خطا مواجه شد
CANCELED	عمليات پرداخت توسط کاربر لغو شد
REVERSED	تراکنش برگشت خورده است
UNVERIFIED	تراکنش توسط پذیرنده تایيدنشد
VERIFY_PENDING	تراکنش در انتظار تایيدپذیرنده است

توجه:

• چنانچه فيلد وضعيت تراکنش (status در جدول PardakhtInquiryData) مقداری غير از SUCCEED داشته باشد، مقادیر فيلدهای payment_date،tracking_code، card_number خالی برخواهند گشت.

جدول کد های وضعیت

عنوان	description	توضیحات
1	Ok	موفق
1-	invalidRequest	درخواست نامعتبر (خطا در پارامترهای ورودی)
2-	inactiveGateway	درگاه فعال نیست
3-	retryToken	توکن تکراری است
4-	amountLimitExceed	مبلغ بیشتر از سقف مجاز درگاه است
5-	invalidRefNum	شناسه ref_num معتبر نیست
6-	retryVerification	تراکنش قبلا وریفای شده است
7-	badData	پارامترهای ارسال شده نامعتبر است
8-	trNotVerifiable	تراکنش را نمیتوان وریفای کرد
9-	trNotVerified	تراکنش وریفای نشد
98-	paymentFailed	تراکنش ناموفق
99-	error	خطای سامانه

سرویس ریزتراکنش های درگاه

• https://core.paystar.ir/api/pardakht/get-transactions

این وبسرویس جهت دریافت ریزتراکنش های درگاه می باشد و با متد GET فراخوانی می شود.

Header درخواست

key	value
Content-Type	application/json
Authorization	Bearer <YOUR_GATEWAY_ID>

پارامترهای ورودی

شرح	نوع داده	نوع فیلد	اجباری
from_date	jalalidate	تاریخ شمسی (مثال: 01-01-1401)	بله
to_date	jalalidate	تاریخ شمسی (مثال: 02-01-1401)	بله
sign	string	امضاء	بله
status	string	وضعيت تراکنش (با مقادیر موجود در جدول وضعيت تراکنش)	خیر
offset	int	تعداد ردیف‌هایی است که باید از ابتدای نتایج جستجو یا نمایش حذف شود	درصورت وارد شدن size
size	int	تعداد تراکنش (پیشفرض 100)	درصورت وارد شدن offset

توجه:

• برای ساخت امضا از متد HMAC و الگوریتم رمزنگاری SHA512 استفاده کنيد. کليد مورد نياز برای رمزنگاری، در هنگام ساخت درگاه در اختيار شما قرار میگيرد. آماده سازی دادهها برای امضا به صورت زیر میباشد:

from_date#your_gateway_id#to_date

پارامترهای خرجی

عنوان	نوع داده	شرح
status	int	جدول وضعيت
message	string	پيام سيستم
data	data	جدول نوع داده data

پارامترهای خروجی (درصورت غیرمجاز بودن درگاه)

عنوان	نوع داده	شرح
status	string	مقدار ثابت unauthenticated
action	string	مقدار ثابت PardakhtInquiry
tag	string	مقدار ثابت unauthenticated
message	string	پيام سيستم
data	string	-
api_version	string	نسخه API

جدول نوع داده data

عنوان	نوع داده	شرح
count	int	تعداد تراکنش
transactions	transactionData	لیست تراکنش ها که درجدول transactionData قابل مشاهده می باشد

جدول نوع داده transactionData

عنوان	نوع داده	شرح
transaction_id	string	شناسه یکتای تراکنش
ref_num	string	شناسه پرداخت
payment_amount	int	مبلغ تراکنش
wage	int	کارمزد
bank_wage	int	کامزد بانک
ref_id	string	شناسه مرجع بانکی
status	string	وضعیت تراکنش
psp	string	نام پی اس پی درگاه
card_number	string	شماره کارت پرداخت کننده
hashed_card_number	string	هش شماره کارت پرداخت کننده
order_id	string	شناسه سفارش
payer_ip	string	ip پرداخت کننده
payer_name	string	نام پرداخت کننده
payer_phone	string	موبایل پرداخت کننده
payer_email	string	ایمیل پرداخت کننده
description	string	توضیحات
payment_date	jalalidate	تاریخ پرداخت
created_at	jalalidate	تاریخ ایجاد

نمونه کد

C# - RestSharp

var client = new RestClient("https://core.paystar.ir/api/pardakht/create");

client.Timeout = -1;

var request = new RestRequest(Method.POST);

request.AddHeader("Authorization", "Bearer YOUR_TERMINAL_ID");

request.AddHeader("Content-Type", "application/json");

var body = @"{

" + "\n" +

@" ""amount"": amount,

" + "\n" +

@" ""order_id"": ""order_id"",

" + "\n" +

@" ""callback"": ""https://site.ir/callback"",

" + "\n" +

@" ""sign"": ""sign""

" + "\n" +

@"}";

request.AddParameter("application/json", body, ParameterType.RequestBody);

IRestResponse response = client.Execute(request);

Console.WriteLine(response.Content);

Dart - http

var headers = {

'Authorization': 'Bearer YOUR_TERMINAL_ID',

'Content-Type': 'application/json'

};

var request = http.Request('POST', Uri.parse('https://core.paystar.ir/api/pardakht/create'));

request.body = '''{\r\n "amount": amount,\r\n "order_id": "order_id",\r\n "callback": "https://site.ir/callback",\r\n "sign": "sign"\r\n}''';

request.headers.addAll(headers);

http.StreamedResponse response = await request.send();

if (response.statusCode == 200) {

print(await response.stream.bytesToString());

}

else {

print(response.reasonPhrase);

}

Go - Native

package main

import (

"fmt"

"strings"

"net/http"

"io/ioutil"

)

func main() {

url := "https://core.paystar.ir/api/pardakht/create"

method := "POST"

payload := strings.NewReader(`{`+"

"+`

"amount": amount,`+"

"+`

"order_id": "order_id",`+"

"+`

"callback": "https://site.ir/callback",`+"

"+`

"sign": "sign"`+"

"+`

}`)

client := &http.Client {

}

req, err := http.NewRequest(method, url, payload)

if err != nil {

fmt.Println(err)

return

}

req.Header.Add("Authorization", "Bearer YOUR_TERMINAL_ID")

req.Header.Add("Content-Type", "application/json")

res, err := client.Do(req)

if err != nil {

fmt.Println(err)

return

}

defer res.Body.Close()

body, err := ioutil.ReadAll(res.Body)

if err != nil {

fmt.Println(err)

return

}

fmt.Println(string(body))

}

Java - Unirest

Unirest.setTimeouts(0, 0);

HttpResponse<String> response = Unirest.post("https://core.paystar.ir/api/pardakht/create")

.header("Authorization", "Bearer YOUR_TERMINAL_ID")

.header("Content-Type", "application/json")

.body("{\r\n \"amount\": amount,\r\n \"order_id\": \"order_id\",\r\n \"callback\": \"https://site.ir/callback\",\r\n \"sign\": \"sign\"\r\n}")

.asString();

JavaScript - jQuery

var settings = {

"url": "https://core.paystar.ir/api/pardakht/create",

"method": "POST",

"timeout": 0,

"headers": {

"Authorization": "Bearer YOUR_TERMINAL_ID",

"Content-Type": "application/json"

},

"data": "{\r\n \"amount\": amount,\r\n \"order_id\": \"order_id\",\r\n \"callback\": \"https://site.ir/callback\",\r\n \"sign\": \"sign\"\r\n}",

};

$.ajax(settings).done(function (response) {

console.log(response);

});

PHP-cURL

<?php

$curl = curl_init();

curl_setopt_array($curl, array(

CURLOPT_URL => 'https://core.paystar.ir/api/pardakht/create',

CURLOPT_RETURNTRANSFER => true,

CURLOPT_ENCODING => '',

CURLOPT_MAXREDIRS => 10,

CURLOPT_TIMEOUT => 0,

CURLOPT_FOLLOWLOCATION => true,

CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,

CURLOPT_CUSTOMREQUEST => 'POST',

CURLOPT_POSTFIELDS =>'{

"amount": amount,

"order_id": "order_id",

"callback": "https://site.ir/callback",

"sign": "sign"

}',

CURLOPT_HTTPHEADER => array(

'Authorization: Bearer YOUR_TERMINAL_ID',

'Content-Type: application/json'

),

));

$response = curl_exec($curl);

curl_close($curl);

echo $response;

Python - Requests

import requests

import json

url = "https://core.paystar.ir/api/pardakht/create"

payload = "{\r\n \"amount\": amount,\r\n \"order_id\": \"order_id\",\r\n \"callback\": \"https://site.ir/callback\",\r\n \"sign\": \"sign\"\r\n}"

headers = {

'Authorization': 'Bearer YOUR_TERMINAL_ID',

'Content-Type': 'application/json'

}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.text)