چطور شروع کنید؟
از درخواست کلید تا اولین پرداخت، مسیر کوتاه و شفاف است.
درخواست کلید از پشتیبانی
در تلگرام به پشتیبانی پیام بدهید؛ پس از بررسی، کلید API اختصاصی شما در پنل مدیریت ساخته و تحویل داده میشود.
اتصال با یک درخواست API
با یک درخواست POST مبلغ و آدرس بازگشت را بفرستید؛ نشانی صفحه پرداخت را تحویل بگیرید و کاربر را به آن هدایت کنید.
دریافت پرداخت و گزارش
پس از پرداخت، کاربر به سایت شما برمیگردد، نتیجه با استعلام API تأیید میشود و تراکنش در گزارش سامانه ثبت میگردد.
اتصال با API — ساده و سریع
کلید API فقط از طریق پشتیبانی صادر میشود. با این کلید، ساخت پرداخت و استعلام وضعیت، هرکدام با یک درخواست انجام میشود.
| پارامتر | توضیح |
|---|---|
Authorization | هدر احراز هویت: Bearer pg_xxxx اجباری |
amount | مبلغ به تومان (عدد صحیح) — بین حداقل و حداکثر مجاز سامانه اجباری |
callback | آدرس بازگشت کاربر پس از پرداخت (https) — اگر برای API شما آدرس ثابتی ثبت شده باشد، لازم نیست و مقدار ارسالی نادیده گرفته میشود |
description | توضیح دلخواه سفارش (اختیاری، حداکثر ۱۲۰ کاراکتر) |
order_id | شناسه سفارش خودتان (اختیاری، حداکثر ۴۰ کاراکتر) |
invoice_url در پاسخ درخواست و پس از پرداخت در پارامترهای بازگشت هم ارسال میشود. کاربر با پارامترهای tx_id، status، amount، ref به آدرس بازگشت شما برمیگردد (در پاسخ درخواست، فیلد callback آدرس مؤثر بازگشت را نشان میدهد) و نتیجه نهایی همیشه با استعلام وضعیت قابل تأیید است: GET /api/pg/status?tx=… شناسه تراکنشها (tx_id) با پیشوند اختصاصی API شما ساخته میشوند — مثل BRAND_xxxxxxxxxx — که از پنل مدیریت قابل تنظیم است؛ صفحه اعتماد عمومی کسبوکار هم در نشانی /trust/{دامنه} در دسترس است.// ساخت پرداخت $ch = curl_init('https://example.com/api/pg/request'); curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_HTTPHEADER => ['Content-Type: application/json', 'Authorization: Bearer pg_xxxxxxxxxxxx'], CURLOPT_POSTFIELDS => json_encode([ 'amount' => 150000, 'callback' => 'https://your-site.ir/pay/result', 'order_id' => '1024', 'description' => 'سفارش ۱۰۲۴', ]), ]); $res = json_decode(curl_exec($ch), true); // هدایت کاربر به صفحه پرداخت header('Location: ' . $res['payment_url']);
// ساخت پرداخت const res = await fetch('https://example.com/api/pg/request', { method: 'POST', headers: { 'Content-Type': 'application/json', 'Authorization': 'Bearer pg_xxxxxxxxxxxx', }, body: JSON.stringify({ amount: 150000, // تومان callback: 'https://your-site.ir/pay/result', order_id: '1024', description: 'سفارش ۱۰۲۴', }), }).then(r => r.json()); // هدایت کاربر به صفحه پرداخت location.href = res.payment_url;
# ۱) ساخت پرداخت — کتابخانهٔ requests import requests API = "https://example.com/api/pg/request" STAT = "https://example.com/api/pg/status" HEAD = {"Authorization": "Bearer pg_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"} r = requests.post(API, headers=HEAD, json={ "amount": 150000, # تومان "callback": "https://your-site.ir/pay/result", "order_id": "1024", }).json() if not r.get("ok"): raise SystemExit(r.get("error")) print(r["tx_id"], r["payment_url"]) # کاربر را به payment_url هدایت کنید # ۲) استعلام وضعیت — مثلاً در صفحهٔ بازگشت s = requests.get(STAT, headers=HEAD, params={"tx": r["tx_id"]}).json() if s.get("status") == "paid": print("پرداخت موفق — رسید:", s["ref"])
# ۱) ساخت پرداخت curl -s -X POST https://example.com/api/pg/request \ -H "Content-Type: application/json" \ -H "Authorization: Bearer pg_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \ -d '{"amount":150000,"callback":"https://your-site.ir/pay/result","order_id":"1024"}' # پاسخ: کاربر را به payment_url هدایت کنید # ۲) استعلام وضعیت — status == paid یعنی پرداخت موفق curl -s "https://example.com/api/pg/status?tx=TX_ID" \ -H "Authorization: Bearer pg_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
<?php /* وردپرس — در functions.php قالب یا یک افزونهٔ کوچک */ // ۱) ساخت پرداخت و هدایت کاربر function mypg_create($amount, $order_id) { $res = wp_remote_post('https://example.com/api/pg/request', [ 'timeout' => 25, 'headers' => ['Content-Type' => 'application/json', 'Authorization' => 'Bearer pg_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx'], 'body' => wp_json_encode([ 'amount' => (int)$amount, // تومان 'callback' => home_url('/pay/result'), // آدرس بازگشت شما 'order_id' => (string)$order_id, ]), ]); return json_decode(wp_remote_retrieve_body($res), true); } // $j = mypg_create(150000, 1024); wp_redirect($j['payment_url']); exit; // ۲) صفحهٔ بازگشت — همیشه استعلام بزنید، به پارامترهای URL اعتماد نکنید add_action('template_redirect', function () { if (empty($_GET['tx_id'])) return; $res = wp_remote_get('https://example.com/api/pg/status?tx=' . rawurlencode($_GET['tx_id']), [ 'timeout' => 25, 'headers' => ['Authorization' => 'Bearer pg_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx'], ]); $j = json_decode(wp_remote_retrieve_body($res), true); if (!empty($j['ok']) && $j['status'] === 'paid' && (int)$j['amount'] === (int)$_GET['amount']) { // پرداخت موفق — سفارش را تأیید کنید } });
<?php /* ووکامرس — افزونهٔ کوچک درگاه؛ در wp-content/plugins بگذارید */ /* Plugin Name: درگاه پرداخت سفارشی */ add_filter('woocommerce_payment_gateways', function ($g) { $g[] = 'WC_MyPG_Gateway'; return $g; }); add_action('plugins_loaded', function () { if (!class_exists('WC_Payment_Gateway')) return; class WC_MyPG_Gateway extends WC_Payment_Gateway { public function __construct() { $this->id = 'mypg'; $this->method_title = 'پرداخت آنلاین'; $this->init_settings(); $this->init_form_fields(); $this->title = $this->get_option('title', 'پرداخت آنلاین'); $this->api_key = $this->get_option('api_key'); add_action('woocommerce_update_options_payment_gateways_' . $this->id, [$this, 'process_admin_options']); } public function init_form_fields() { $this->form_fields = [ 'enabled' => ['title' => 'فعال', 'type' => 'checkbox', 'default' => 'yes'], 'api_key' => ['title' => 'کلید API', 'type' => 'text'], ]; } public function process_payment($order_id) { $order = wc_get_order($order_id); $res = wp_remote_post('https://example.com/api/pg/request', [ 'timeout' => 25, 'headers' => ['Content-Type' => 'application/json', 'Authorization' => 'Bearer ' . $this->api_key], 'body' => wp_json_encode([ 'amount' => (int)$order->get_total(), // اگر واحد پول فروشگاه تومان باشد 'callback' => $this->get_return_url($order), 'order_id' => (string)$order_id, ]), ]); $j = json_decode(wp_remote_retrieve_body($res), true); if (empty($j['ok'])) { wc_add_notice('خطا در ایجاد پرداخت', 'error'); return; } return ['result' => 'success', 'redirect' => $j['payment_url']]; } } });
package main import ( "bytes" "encoding/json" "fmt" "io" "net/http" ) func statusOf(url, key string) string { req, _ := http.NewRequest("GET", url, nil) req.Header.Set("Authorization", "Bearer "+key) res, err := http.DefaultClient.Do(req) if err != nil { panic(err) } defer res.Body.Close() b, _ := io.ReadAll(res.Body) return string(b) } func main() { key := "pg_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" body, _ := json.Marshal(map[string]any{ "amount": 150000, // تومان "callback": "https://your-site.ir/pay/result", "order_id": "1024", }) req, _ := http.NewRequest("POST", "https://example.com/api/pg/request", bytes.NewReader(body)) req.Header.Set("Content-Type", "application/json") req.Header.Set("Authorization", "Bearer "+key) res, err := http.DefaultClient.Do(req) if err != nil { panic(err) } defer res.Body.Close() out, _ := io.ReadAll(res.Body) fmt.Println(string(out)) // پاسخ: payment_url → هدایت کاربر fmt.Println(statusOf("https://example.com/api/pg/status?tx=TX_ID", key)) // status == "paid" }
// جاوا ۱۱ به بالا — بدون کتابخانهٔ جانبی import java.net.URI; import java.net.URLEncoder; import java.net.http.*; import java.nio.charset.StandardCharsets; class Pay { static final String KEY = "Bearer pg_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"; public static void main(String[] a) throws Exception { var http = HttpClient.newHttpClient(); var body = "{\"amount\":150000,\"callback\":\"https://your-site.ir/pay/result\",\"order_id\":\"1024\"}"; var req = HttpRequest.newBuilder(URI.create("https://example.com/api/pg/request")) .header("Content-Type", "application/json").header("Authorization", KEY) .POST(HttpRequest.BodyPublishers.ofString(body)).build(); System.out.println(http.send(req, HttpResponse.BodyHandlers.ofString()).body()); // پاسخ: payment_url → کاربر را به همان نشانی هدایت کنید var st = "https://example.com/api/pg/status?tx=" + URLEncoder.encode("TX_ID", StandardCharsets.UTF_8); var req2 = HttpRequest.newBuilder(URI.create(st)).header("Authorization", KEY).GET().build(); System.out.println(http.send(req2, HttpResponse.BodyHandlers.ofString()).body()); // status == "paid" یعنی پرداخت موفق } }
// .NET 6 به بالا using System.Net.Http.Json; var http = new HttpClient(); http.DefaultRequestHeaders.Add("Authorization", "Bearer pg_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"); // ۱) ساخت پرداخت var res = await http.PostAsJsonAsync("https://example.com/api/pg/request", new { amount = 150000, // تومان callback = "https://your-site.ir/pay/result", order_id = "1024", }); var j = await res.Content.ReadFromJsonAsync<PgResp>(); Console.WriteLine(j.payment_url); // هدایت کاربر به همین نشانی // ۲) استعلام وضعیت var s = await http.GetFromJsonAsync<PgResp>("https://example.com/api/pg/status?tx=" + Uri.EscapeDataString(j.tx_id)); Console.WriteLine(s.status); // "paid" یعنی پرداخت موفق class PgResp { public bool ok { get; set; } public string tx_id { get; set; } = ""; public string payment_url { get; set; } = ""; public string status { get; set; } = ""; public int amount { get; set; } public string ref { get; set; } = ""; }
require "net/http" require "json" require "uri" KEY = "pg_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" BASE = "https://example.com" # ۱) ساخت پرداخت uri = URI("#{BASE}/api/pg/request") req = Net::HTTP::Post.new(uri) req["Content-Type"] = "application/json" req["Authorization"] = "Bearer #{KEY}" req.body = { amount: 150000, # تومان callback: "https://your-site.ir/pay/result", order_id: "1024" }.to_json res = JSON.parse(Net::HTTP.start(uri.host, uri.port, use_ssl: true) { |h| h.request(req) }.body) abort res["error"] unless res["ok"] puts res["payment_url"] # هدایت کاربر به همین نشانی # ۲) استعلام وضعیت uri2 = URI("#{BASE}/api/pg/status?tx=#{URI.encode_www_form_component(res['tx_id'])}") req2 = Net::HTTP::Get.new(uri2) req2["Authorization"] = "Bearer #{KEY}" s = JSON.parse(Net::HTTP.start(uri2.host, uri2.port, use_ssl: true) { |h| h.request(req2) }.body) puts "پرداخت موفق — رسید: #{s['ref']}" if s["status"] == "paid"
مسیر یک پرداخت
پرداخت از طریق درگاه رسمی انجام میشود، نتیجه در سامانه ثبت میگردد و تسویه با پذیرنده توسط مدیر سامانه انجام و گزارش میشود.
ابزارهایی برای آرامش خیال شما
درگاههای رسمی
پرداخت از طریق درگاه رسمی بانکی انجام میشود؛ بدون واسطههای غیرمجاز.
اتصال ساده
یک درخواست برای ساخت پرداخت، یک درخواست برای استعلام وضعیت — بدون پیچیدگی.
امنیت پرداخت
وریفای کامل سمت سرور با خود درگاه، جلوگیری از دستکاری مبلغ و تکرار تراکنش.
گزارش دقیق
هر تراکنش با مبلغ، وضعیت، فاکتور و زمان ثبت میشود؛ گزارش هر API جداگانه قابل دریافت است.
پشتیبانی واقعی
پاسخگویی مستقیم در تلگرام؛ صدور کلید، اتصال و رفع مشکل با همان مسیر پشتیبانی انجام میشود.
تجربه پرداخت روان
صفحه پرداخت سبک و موبایلپسند؛ مشتری شما بدون سردرگمی به درگاه رسمی میرسد.
مجوزهای سامانه
مجوزها و نشانهای رسمی این سامانه.
قوانین و مقررات
قواعد همکاری، پرداخت و تسویه در این سامانه.
پرسشهای پرتکرار
آماده اتصال هستید؟
به پشتیبانی پیام بدهید؛ کلید API شما ساخته میشود و طبق مستندات همین صفحه، چند دقیقهای متصل شوید.