راهنمای وبسرویس - اتصال به api درگاه پرداخت

REST API
SOAP API

ایجاد فاکتور

آدرس : https://api.sepordeh.com/merchant/invoices/add/

نام پارامتر	وضعیت	نوع داده	نمونه	شرح
merchant	اجباری	string	KnIT45OvAnd1584271146:8zN9iO1Y11tg6LVl	مرچنت را باید در بخش کسب و کارها از داخل پنل بردارید
amount	اجباری	number	150000	مبلغ فاکتور به تومان
callback	اجباری	string	http://website.com/callback	آدرس بازگشت بعد از اتمام عملیات پرداخت
description	اختیاری	string	خرید گوشی موبایل	توضیحات در مورد فاکتور
orderId	اختیاری	number	14886	شماره سفارش در سیستم شما (حداکثر 20 رقمی)
phone	اختیاری	number	09121234567	شماره موبایل پرداخت کننده
card	اختیاری	number	6037123456789123	محدود کردن شماره کارت پرداخت کننده

Response
CURL
PHP
Python
Node.js
JavaScript
C#
Java
Ruby
GO

{
    "status": 200, // وضعیت 200 به معنای موفقیت آمیز بودن ایجاد فاکتور می باشد
    "message": "add completed",
    "information": {
        "invoice_id": 4 // این عدد شماره فاکتور ایجاد شده می باشد که باید ذخیره نمایید
    }
}

curl --location --request POST 'https://api.sepordeh.com/merchant/invoices/add/' \
--form 'merchant="KnIT45OvAnd1584271146:8zN9iO1Y11tg6LVl"' \
--form 'amount="150000"' \
--form 'callback="http://website.com/callback"' \
--form 'description="خرید گوشی موبایل"' \
--form 'orderId="14886"' \
--form 'phone="09121234567"'


$merchant = "KnIT45OvAnd1584271146:8zN9iO1Y11tg6LVl";
$amount = 150000;
$callback = "http://website.com/callback";
$description = "خرید گوشی موبایل";
$orderId = "14886";
$phone = "09121234567";

$parameters = array(
    "merchant" => $merchant,
    "amount" => $amount,
    "callback" => $callback,
    "description" => $description,
    "orderId" => $orderId,
    "phone" => $phone
);

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://api.sepordeh.com/merchant/invoices/add/");
curl_setopt($ch, CURLOPT_POSTFIELDS, $parameters);
curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, false);
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$result = curl_exec($ch);

if(curl_errno($ch)){
    die("CURL ERROR: " . curl_error($ch));
} else {
    $result = json_decode($result);
    if($result->status == 200){
        $invoice_id = $result->information->invoice_id;
        // ذخیره invoice_id در دیتابیس
        // ارجاع به صفحه پرداخت
        header('Location: https://api.sepordeh.com/merchant/invoices/pay/id:' . $invoice_id, true, 302);
        exit();
    } else {
        echo "خطا: " . $result->message;
    }
}
curl_close($ch);

import requests
import json

# پارامترهای درخواست
merchant = "KnIT45OvAnd1584271146:8zN9iO1Y11tg6LVl"
amount = 150000
callback = "http://website.com/callback"
description = "خرید گوشی موبایل"
order_id = "14886"
phone = "09121234567"

# آدرس API
url = "https://api.sepordeh.com/merchant/invoices/add/"

# داده‌های ارسالی
data = {
    "merchant": merchant,
    "amount": amount,
    "callback": callback,
    "description": description,
    "orderId": order_id,
    "phone": phone
}

try:
    # ارسال درخواست POST
    response = requests.post(url, data=data, verify=False)
    
    # تبدیل پاسخ به JSON
    result = response.json()
    
    if result["status"] == 200:
        invoice_id = result["information"]["invoice_id"]
        print(f"فاکتور با موفقیت ایجاد شد. شماره فاکتور: {invoice_id}")
        
        # ارجاع به صفحه پرداخت
        payment_url = f"https://api.sepordeh.com/merchant/invoices/pay/id:{invoice_id}"
        print(f"آدرس پرداخت: {payment_url}")
    else:
        print(f"خطا: {result['message']}")
        
except requests.exceptions.RequestException as e:
    print(f"خطا در ارسال درخواست: {e}")

const axios = require('axios');
const FormData = require('form-data');

// پارامترهای درخواست
const merchant = "KnIT45OvAnd1584271146:8zN9iO1Y11tg6LVl";
const amount = 150000;
const callback = "http://website.com/callback";
const description = "خرید گوشی موبایل";
const orderId = "14886";
const phone = "09121234567";

// ایجاد فرم دیتا
const formData = new FormData();
formData.append('merchant', merchant);
formData.append('amount', amount);
formData.append('callback', callback);
formData.append('description', description);
formData.append('orderId', orderId);
formData.append('phone', phone);

// ارسال درخواست
axios.post('https://api.sepordeh.com/merchant/invoices/add/', formData, {
    headers: formData.getHeaders(),
    httpsAgent: new (require('https').Agent)({
        rejectUnauthorized: false
    })
})
.then(response => {
    const result = response.data;
    
    if (result.status === 200) {
        const invoiceId = result.information.invoice_id;
        console.log(`فاکتور با موفقیت ایجاد شد. شماره فاکتور: ${invoiceId}`);
        
        // ارجاع به صفحه پرداخت
        const paymentUrl = `https://api.sepordeh.com/merchant/invoices/pay/id:${invoiceId}`;
        console.log(`آدرس پرداخت: ${paymentUrl}`);
        
        // برای ریدایرکت در Express.js:
        // res.redirect(302, paymentUrl);
    } else {
        console.error(`خطا: ${result.message}`);
    }
})
.catch(error => {
    console.error('خطا در ارسال درخواست:', error.message);
});

// استفاده از Fetch API در مرورگر
async function createInvoice() {
    const merchant = "KnIT45OvAnd1584271146:8zN9iO1Y11tg6LVl";
    const amount = 150000;
    const callback = "http://website.com/callback";
    const description = "خرید گوشی موبایل";
    const orderId = "14886";
    const phone = "09121234567";
    
    const formData = new FormData();
    formData.append('merchant', merchant);
    formData.append('amount', amount);
    formData.append('callback', callback);
    formData.append('description', description);
    formData.append('orderId', orderId);
    formData.append('phone', phone);
    
    try {
        const response = await fetch('https://api.sepordeh.com/merchant/invoices/add/', {
            method: 'POST',
            body: formData
        });
        
        const result = await response.json();
        
        if (result.status === 200) {
            const invoiceId = result.information.invoice_id;
            console.log(`فاکتور با موفقیت ایجاد شد. شماره فاکتور: ${invoiceId}`);
            
            // ارجاع به صفحه پرداخت
            const paymentUrl = `https://api.sepordeh.com/merchant/invoices/pay/id:${invoiceId}`;
            window.location.href = paymentUrl;
        } else {
            console.error(`خطا: ${result.message}`);
            alert(`خطا: ${result.message}`);
        }
    } catch (error) {
        console.error('خطا در ارسال درخواست:', error);
        alert('خطا در ارتباط با سرور');
    }
}

// فراخوانی تابع
createInvoice();

using System;
using System.Collections.Generic;
using System.Net.Http;
using System.Threading.Tasks;
using Newtonsoft.Json;

public class SepordehPayment
{
    private static readonly HttpClient client = new HttpClient();
    
    public class InvoiceResponse
    {
        public int Status { get; set; }
        public string Message { get; set; }
        public InvoiceInfo Information { get; set; }
    }
    
    public class InvoiceInfo
    {
        public int Invoice_Id { get; set; }
    }
    
    public static async Task CreateInvoice()
    {
        string merchant = "KnIT45OvAnd1584271146:8zN9iO1Y11tg6LVl";
        int amount = 150000;
        string callback = "http://website.com/callback";
        string description = "خرید گوشی موبایل";
        string orderId = "14886";
        string phone = "09121234567";
        
        var formContent = new FormUrlEncodedContent(new[]
        {
            new KeyValuePair<string, string>("merchant", merchant),
            new KeyValuePair<string, string>("amount", amount.ToString()),
            new KeyValuePair<string, string>("callback", callback),
            new KeyValuePair<string, string>("description", description),
            new KeyValuePair<string, string>("orderId", orderId),
            new KeyValuePair<string, string>("phone", phone)
        });
        
        try
        {
            var response = await client.PostAsync(
                "https://api.sepordeh.com/merchant/invoices/add/", 
                formContent
            );
            
            string responseBody = await response.Content.ReadAsStringAsync();
            var result = JsonConvert.DeserializeObject<InvoiceResponse>(responseBody);
            
            if (result.Status == 200)
            {
                int invoiceId = result.Information.Invoice_Id;
                Console.WriteLine($"فاکتور با موفقیت ایجاد شد. شماره فاکتور: {invoiceId}");
                
                // ارجاع به صفحه پرداخت
                string paymentUrl = $"https://api.sepordeh.com/merchant/invoices/pay/id:{invoiceId}";
                // Response.Redirect(paymentUrl);
            }
            else
            {
                Console.WriteLine($"خطا: {result.Message}");
            }
        }
        catch (HttpRequestException e)
        {
            Console.WriteLine($"خطا در ارسال درخواست: {e.Message}");
        }
    }
}

import java.io.*;
import java.net.*;
import java.util.*;
import org.json.*;

public class SepordehPayment {
    
    public static void createInvoice() {
        String merchant = "KnIT45OvAnd1584271146:8zN9iO1Y11tg6LVl";
        int amount = 150000;
        String callback = "http://website.com/callback";
        String description = "خرید گوشی موبایل";
        String orderId = "14886";
        String phone = "09121234567";
        
        try {
            URL url = new URL("https://api.sepordeh.com/merchant/invoices/add/");
            HttpURLConnection conn = (HttpURLConnection) url.openConnection();
            conn.setRequestMethod("POST");
            conn.setDoOutput(true);
            
            // ساخت پارامترها
            String params = "merchant=" + URLEncoder.encode(merchant, "UTF-8") +
                          "&amount=" + amount +
                          "&callback=" + URLEncoder.encode(callback, "UTF-8") +
                          "&description=" + URLEncoder.encode(description, "UTF-8") +
                          "&orderId=" + orderId +
                          "&phone=" + phone;
            
            // ارسال درخواست
            OutputStreamWriter writer = new OutputStreamWriter(conn.getOutputStream());
            writer.write(params);
            writer.flush();
            writer.close();
            
            // خواندن پاسخ
            BufferedReader reader = new BufferedReader(
                new InputStreamReader(conn.getInputStream())
            );
            String line;
            StringBuilder response = new StringBuilder();
            
            while ((line = reader.readLine()) != null) {
                response.append(line);
            }
            reader.close();
            
            // پردازش پاسخ JSON
            JSONObject jsonResponse = new JSONObject(response.toString());
            
            if (jsonResponse.getInt("status") == 200) {
                int invoiceId = jsonResponse.getJSONObject("information")
                                           .getInt("invoice_id");
                System.out.println("فاکتور با موفقیت ایجاد شد. شماره فاکتور: " + invoiceId);
                
                // ارجاع به صفحه پرداخت
                String paymentUrl = "https://api.sepordeh.com/merchant/invoices/pay/id:" + invoiceId;
                // response.sendRedirect(paymentUrl);
            } else {
                System.out.println("خطا: " + jsonResponse.getString("message"));
            }
            
        } catch (Exception e) {
            System.err.println("خطا در ارسال درخواست: " + e.getMessage());
        }
    }
    
    public static void main(String[] args) {
        createInvoice();
    }
}

require 'net/http'
require 'uri'
require 'json'

# پارامترهای درخواست
merchant = "KnIT45OvAnd1584271146:8zN9iO1Y11tg6LVl"
amount = 150000
callback = "http://website.com/callback"
description = "خرید گوشی موبایل"
order_id = "14886"
phone = "09121234567"

# آدرس API
uri = URI.parse("https://api.sepordeh.com/merchant/invoices/add/")

# ساخت درخواست
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_NONE

request = Net::HTTP::Post.new(uri.request_uri)
request.set_form_data({
  "merchant" => merchant,
  "amount" => amount,
  "callback" => callback,
  "description" => description,
  "orderId" => order_id,
  "phone" => phone
})

begin
  # ارسال درخواست
  response = http.request(request)
  
  # پردازش پاسخ
  result = JSON.parse(response.body)
  
  if result["status"] == 200
    invoice_id = result["information"]["invoice_id"]
    puts "فاکتور با موفقیت ایجاد شد. شماره فاکتور: #{invoice_id}"
    
    # ارجاع به صفحه پرداخت
    payment_url = "https://api.sepordeh.com/merchant/invoices/pay/id:#{invoice_id}"
    puts "آدرس پرداخت: #{payment_url}"
    
    # برای ریدایرکت در Rails:
    # redirect_to payment_url, status: 302
  else
    puts "خطا: #{result['message']}"
  end
  
rescue => e
  puts "خطا در ارسال درخواست: #{e.message}"
end

package main

import (
    "bytes"
    "encoding/json"
    "fmt"
    "io/ioutil"
    "net/http"
    "net/url"
)

type InvoiceResponse struct {
    Status      int    `json:"status"`
    Message     string `json:"message"`
    Information struct {
        InvoiceID int `json:"invoice_id"`
    } `json:"information"`
}

func createInvoice() {
    merchant := "KnIT45OvAnd1584271146:8zN9iO1Y11tg6LVl"
    amount := "150000"
    callback := "http://website.com/callback"
    description := "خرید گوشی موبایل"
    orderId := "14886"
    phone := "09121234567"
    
    // ساخت فرم دیتا
    formData := url.Values{
        "merchant":    {merchant},
        "amount":      {amount},
        "callback":    {callback},
        "description": {description},
        "orderId":     {orderId},
        "phone":       {phone},
    }
    
    // ارسال درخواست POST
    resp, err := http.PostForm(
        "https://api.sepordeh.com/merchant/invoices/add/",
        formData,
    )
    if err != nil {
        fmt.Printf("خطا در ارسال درخواست: %v\n", err)
        return
    }
    defer resp.Body.Close()
    
    // خواندن پاسخ
    body, err := ioutil.ReadAll(resp.Body)
    if err != nil {
        fmt.Printf("خطا در خواندن پاسخ: %v\n", err)
        return
    }
    
    // پردازش JSON
    var result InvoiceResponse
    err = json.Unmarshal(body, &result)
    if err != nil {
        fmt.Printf("خطا در پردازش JSON: %v\n", err)
        return
    }
    
    if result.Status == 200 {
        invoiceID := result.Information.InvoiceID
        fmt.Printf("فاکتور با موفقیت ایجاد شد. شماره فاکتور: %d\n", invoiceID)
        
        // ارجاع به صفحه پرداخت
        paymentURL := fmt.Sprintf(
            "https://api.sepordeh.com/merchant/invoices/pay/id:%d",
            invoiceID,
        )
        fmt.Printf("آدرس پرداخت: %s\n", paymentURL)
        
        // برای ریدایرکت:
        // http.Redirect(w, r, paymentURL, http.StatusFound)
    } else {
        fmt.Printf("خطا: %s\n", result.Message)
    }
}

func main() {
    createInvoice()
}

ارجاع به صفحه پرداخت

آدرس : https://api.sepordeh.com/merchant/invoices/pay/id:{{invoice_id}}

مقدار {{invoice_id}} را با شماره فاکتور دریافتی در مرحله قبل جایگزین کنید.

PHP
Python
Node.js
JavaScript
C#
Java
Ruby
GO

// PHP - ریدایرکت به صفحه پرداخت
header('Location: https://api.sepordeh.com/merchant/invoices/pay/id:' . $invoice_id, true, 302);
exit();

# Python - Flask
from flask import redirect

@app.route('/pay')
def redirect_to_payment():
    invoice_id = 4  # شماره فاکتور دریافتی
    payment_url = f"https://api.sepordeh.com/merchant/invoices/pay/id:{invoice_id}"
    return redirect(payment_url, code=302)

# Python - Django
from django.shortcuts import redirect

def redirect_to_payment(request):
    invoice_id = 4  # شماره فاکتور دریافتی
    payment_url = f"https://api.sepordeh.com/merchant/invoices/pay/id:{invoice_id}"
    return redirect(payment_url)

// Node.js - Express
app.get('/pay', (req, res) => {
    const invoiceId = 4; // شماره فاکتور دریافتی
    const paymentUrl = `https://api.sepordeh.com/merchant/invoices/pay/id:${invoiceId}`;
    res.redirect(302, paymentUrl);
});

// JavaScript - Browser
function redirectToPayment(invoiceId) {
    const paymentUrl = `https://api.sepordeh.com/merchant/invoices/pay/id:${invoiceId}`;
    window.location.href = paymentUrl;
}

// فراخوانی تابع با شماره فاکتور
redirectToPayment(4);

// C# - ASP.NET MVC
public ActionResult RedirectToPayment(int invoiceId)
{
    string paymentUrl = $"https://api.sepordeh.com/merchant/invoices/pay/id:{invoiceId}";
    return Redirect(paymentUrl);
}

// C# - ASP.NET Core
public IActionResult RedirectToPayment(int invoiceId)
{
    string paymentUrl = $"https://api.sepordeh.com/merchant/invoices/pay/id:{invoiceId}";
    return Redirect(paymentUrl);
}

// Java - Servlet
protected void doGet(HttpServletRequest request, HttpServletResponse response) 
        throws ServletException, IOException {
    int invoiceId = 4; // شماره فاکتور دریافتی
    String paymentUrl = "https://api.sepordeh.com/merchant/invoices/pay/id:" + invoiceId;
    response.sendRedirect(paymentUrl);
}

// Java - Spring Boot
@GetMapping("/pay")
public RedirectView redirectToPayment(@RequestParam int invoiceId) {
    String paymentUrl = "https://api.sepordeh.com/merchant/invoices/pay/id:" + invoiceId;
    return new RedirectView(paymentUrl);
}

# Ruby - Rails
def redirect_to_payment
  invoice_id = 4 # شماره فاکتور دریافتی
  payment_url = "https://api.sepordeh.com/merchant/invoices/pay/id:#{invoice_id}"
  redirect_to payment_url, status: 302
end

# Ruby - Sinatra
get '/pay' do
  invoice_id = 4 # شماره فاکتور دریافتی
  payment_url = "https://api.sepordeh.com/merchant/invoices/pay/id:#{invoice_id}"
  redirect payment_url, 302
end

// GO - HTTP Handler
func redirectToPayment(w http.ResponseWriter, r *http.Request) {
    invoiceID := 4 // شماره فاکتور دریافتی
    paymentURL := fmt.Sprintf(
        "https://api.sepordeh.com/merchant/invoices/pay/id:%d",
        invoiceID,
    )
    http.Redirect(w, r, paymentURL, http.StatusFound)
}

// GO - Gin Framework
func redirectToPayment(c *gin.Context) {
    invoiceID := 4 // شماره فاکتور دریافتی
    paymentURL := fmt.Sprintf(
        "https://api.sepordeh.com/merchant/invoices/pay/id:%d",
        invoiceID,
    )
    c.Redirect(http.StatusFound, paymentURL)
}

بازگشت از صفحه پرداخت

آدرس : http://website.com/callback?authority={{authority}}&&orderId={{orderId}}

هنگام بازگشت به آدرس callback دو پارامتر authority و orderId ارسال می‌گردد (توسط متد GET)

تایید پرداخت

آدرس : https://api.sepordeh.com/merchant/invoices/verify/

نام پارامتر	وضعیت	نوع داده	نمونه	شرح
merchant	اجباری	string	KnIT45OvAnd1584271146:8zN9iO1Y11tg6LVl	مرچنت را باید در بخش کسب و کارها از داخل پنل بردارید
authority	اجباری	number	35684	این مقدار در هنگام بازگشت از صفحه پرداخت به صورت GET ارسال می‌گردد

Response
CURL
PHP
Python
Node.js
JavaScript
C#
Java
Ruby
GO

{
    "status": 200, // وضعیت 200 به معنای موفقیت آمیز بودن پرداخت می باشد
    "message": "paid",
    "information": {
        "invoice_id": 4,
        "card": "6104********4510" // شماره کارت پرداخت کننده می باشد
    }
}

curl --location --request POST 'https://api.sepordeh.com/merchant/invoices/verify/' \
--form 'merchant="KnIT45OvAnd1584271146:8zN9iO1Y11tg6LVl"' \
--form 'authority="35684"'


$merchant = "KnIT45OvAnd1584271146:8zN9iO1Y11tg6LVl";
$orderId = $_GET["orderId"];

if(isset($_GET["authority"])){
    $parameters = array(
        "merchant" => $merchant,
        "authority" => $_GET["authority"],
    );
    
    $ch = curl_init();
    curl_setopt($ch, CURLOPT_URL, "https://api.sepordeh.com/merchant/invoices/verify/");
    curl_setopt($ch, CURLOPT_POSTFIELDS, $parameters);
    curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, false);
    curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    
    $result = curl_exec($ch);
    
    if(curl_errno($ch)){
        die("CURL ERROR: " . curl_error($ch));
    } else {
        $result = json_decode($result);
        
        if($result->status == 200){
            // پرداخت موفق
            $invoice_id = $result->information->invoice_id;
            $card_number = $result->information->card;
            
            echo "پرداخت با موفقیت انجام شد<br>";
            echo "شماره فاکتور: " . $invoice_id . "<br>";
            echo "شماره کارت: " . $card_number . "<br>";
            
            // ذخیره اطلاعات در دیتابیس
            // به‌روزرسانی وضعیت سفارش
        } else {
            echo "خطا: " . $result->message;
        }
    }
    curl_close($ch);
} else {
    echo "پارامتر authority یافت نشد";
}

import requests
import json

def verify_payment(authority, merchant):
    url = "https://api.sepordeh.com/merchant/invoices/verify/"
    
    data = {
        "merchant": merchant,
        "authority": authority
    }
    
    try:
        response = requests.post(url, data=data, verify=False)
        result = response.json()
        
        if result["status"] == 200:
            invoice_id = result["information"]["invoice_id"]
            card_number = result["information"]["card"]
            
            print(f"پرداخت با موفقیت انجام شد")
            print(f"شماره فاکتور: {invoice_id}")
            print(f"شماره کارت: {card_number}")
            
            # ذخیره اطلاعات در دیتابیس
            # به‌روزرسانی وضعیت سفارش
            return True
        else:
            print(f"خطا: {result['message']}")
            return False
            
    except requests.exceptions.RequestException as e:
        print(f"خطا در ارسال درخواست: {e}")
        return False

# استفاده در Flask
from flask import request

@app.route('/callback')
def payment_callback():
    authority = request.args.get('authority')
    order_id = request.args.get('orderId')
    merchant = "KnIT45OvAnd1584271146:8zN9iO1Y11tg6LVl"
    
    if authority:
        verify_payment(authority, merchant)
        return "Payment processed"
    else:
        return "Authority parameter not found", 400

const axios = require('axios');
const FormData = require('form-data');

async function verifyPayment(authority, merchant) {
    const formData = new FormData();
    formData.append('merchant', merchant);
    formData.append('authority', authority);
    
    try {
        const response = await axios.post(
            'https://api.sepordeh.com/merchant/invoices/verify/',
            formData,
            {
                headers: formData.getHeaders(),
                httpsAgent: new (require('https').Agent)({
                    rejectUnauthorized: false
                })
            }
        );
        
        const result = response.data;
        
        if (result.status === 200) {
            const invoiceId = result.information.invoice_id;
            const cardNumber = result.information.card;
            
            console.log('پرداخت با موفقیت انجام شد');
            console.log(`شماره فاکتور: ${invoiceId}`);
            console.log(`شماره کارت: ${cardNumber}`);
            
            // ذخیره اطلاعات در دیتابیس
            // به‌روزرسانی وضعیت سفارش
            return true;
        } else {
            console.error(`خطا: ${result.message}`);
            return false;
        }
    } catch (error) {
        console.error('خطا در ارسال درخواست:', error.message);
        return false;
    }
}

// استفاده در Express.js
app.get('/callback', async (req, res) => {
    const authority = req.query.authority;
    const orderId = req.query.orderId;
    const merchant = "KnIT45OvAnd1584271146:8zN9iO1Y11tg6LVl";
    
    if (authority) {
        const success = await verifyPayment(authority, merchant);
        
        if (success) {
            res.send('پرداخت با موفقیت انجام شد');
        } else {
            res.send('خطا در تایید پرداخت');
        }
    } else {
        res.status(400).send('پارامتر authority یافت نشد');
    }
});

// JavaScript - استفاده در مرورگر
async function verifyPayment(authority, merchant) {
    const formData = new FormData();
    formData.append('merchant', merchant);
    formData.append('authority', authority);
    
    try {
        const response = await fetch(
            'https://api.sepordeh.com/merchant/invoices/verify/',
            {
                method: 'POST',
                body: formData
            }
        );
        
        const result = await response.json();
        
        if (result.status === 200) {
            const invoiceId = result.information.invoice_id;
            const cardNumber = result.information.card;
            
            console.log('پرداخت با موفقیت انجام شد');
            console.log(`شماره فاکتور: ${invoiceId}`);
            console.log(`شماره کارت: ${cardNumber}`);
            
            alert('پرداخت با موفقیت انجام شد');
            return true;
        } else {
            console.error(`خطا: ${result.message}`);
            alert(`خطا: ${result.message}`);
            return false;
        }
    } catch (error) {
        console.error('خطا در ارسال درخواست:', error);
        alert('خطا در ارتباط با سرور');
        return false;
    }
}

// دریافت پارامترها از URL
const urlParams = new URLSearchParams(window.location.search);
const authority = urlParams.get('authority');
const orderId = urlParams.get('orderId');
const merchant = "KnIT45OvAnd1584271146:8zN9iO1Y11tg6LVl";

if (authority) {
    verifyPayment(authority, merchant);
} else {
    alert('پارامتر authority یافت نشد');
}

using System;
using System.Collections.Generic;
using System.Net.Http;
using System.Threading.Tasks;
using Newtonsoft.Json;

public class PaymentVerification
{
    private static readonly HttpClient client = new HttpClient();
    
    public class VerifyResponse
    {
        public int Status { get; set; }
        public string Message { get; set; }
        public VerifyInfo Information { get; set; }
    }
    
    public class VerifyInfo
    {
        public int Invoice_Id { get; set; }
        public string Card { get; set; }
    }
    
    public static async Task<bool> VerifyPayment(string authority, string merchant)
    {
        var formContent = new FormUrlEncodedContent(new[]
        {
            new KeyValuePair<string, string>("merchant", merchant),
            new KeyValuePair<string, string>("authority", authority)
        });
        
        try
        {
            var response = await client.PostAsync(
                "https://api.sepordeh.com/merchant/invoices/verify/",
                formContent
            );
            
            string responseBody = await response.Content.ReadAsStringAsync();
            var result = JsonConvert.DeserializeObject<VerifyResponse>(responseBody);
            
            if (result.Status == 200)
            {
                int invoiceId = result.Information.Invoice_Id;
                string cardNumber = result.Information.Card;
                
                Console.WriteLine("پرداخت با موفقیت انجام شد");
                Console.WriteLine($"شماره فاکتور: {invoiceId}");
                Console.WriteLine($"شماره کارت: {cardNumber}");
                
                // ذخیره اطلاعات در دیتابیس
                // به‌روزرسانی وضعیت سفارش
                return true;
            }
            else
            {
                Console.WriteLine($"خطا: {result.Message}");
                return false;
            }
        }
        catch (HttpRequestException e)
        {
            Console.WriteLine($"خطا در ارسال درخواست: {e.Message}");
            return false;
        }
    }
}

// استفاده در ASP.NET MVC/Core
public async Task<IActionResult> Callback(string authority, string orderId)
{
    string merchant = "KnIT45OvAnd1584271146:8zN9iO1Y11tg6LVl";
    
    if (!string.IsNullOrEmpty(authority))
    {
        bool success = await PaymentVerification.VerifyPayment(authority, merchant);
        
        if (success)
        {
            return View("Success");
        }
        else
        {
            return View("Failed");
        }
    }
    
    return BadRequest("پارامتر authority یافت نشد");
}

import java.io.*;
import java.net.*;
import org.json.*;

public class PaymentVerification {
    
    public static boolean verifyPayment(String authority, String merchant) {
        try {
            URL url = new URL("https://api.sepordeh.com/merchant/invoices/verify/");
            HttpURLConnection conn = (HttpURLConnection) url.openConnection();
            conn.setRequestMethod("POST");
            conn.setDoOutput(true);
            
            String params = "merchant=" + URLEncoder.encode(merchant, "UTF-8") +
                          "&authority=" + authority;
            
            OutputStreamWriter writer = new OutputStreamWriter(conn.getOutputStream());
            writer.write(params);
            writer.flush();
            writer.close();
            
            BufferedReader reader = new BufferedReader(
                new InputStreamReader(conn.getInputStream())
            );
            String line;
            StringBuilder response = new StringBuilder();
            
            while ((line = reader.readLine()) != null) {
                response.append(line);
            }
            reader.close();
            
            JSONObject jsonResponse = new JSONObject(response.toString());
            
            if (jsonResponse.getInt("status") == 200) {
                int invoiceId = jsonResponse.getJSONObject("information")
                                           .getInt("invoice_id");
                String cardNumber = jsonResponse.getJSONObject("information")
                                               .getString("card");
                
                System.out.println("پرداخت با موفقیت انجام شد");
                System.out.println("شماره فاکتور: " + invoiceId);
                System.out.println("شماره کارت: " + cardNumber);
                
                // ذخیره اطلاعات در دیتابیس
                // به‌روزرسانی وضعیت سفارش
                return true;
            } else {
                System.out.println("خطا: " + jsonResponse.getString("message"));
                return false;
            }
            
        } catch (Exception e) {
            System.err.println("خطا در ارسال درخواست: " + e.getMessage());
            return false;
        }
    }
}

// استفاده در Servlet
protected void doGet(HttpServletRequest request, HttpServletResponse response)
        throws ServletException, IOException {
    String authority = request.getParameter("authority");
    String orderId = request.getParameter("orderId");
    String merchant = "KnIT45OvAnd1584271146:8zN9iO1Y11tg6LVl";
    
    if (authority != null && !authority.isEmpty()) {
        boolean success = PaymentVerification.verifyPayment(authority, merchant);
        
        if (success) {
            response.getWriter().println("پرداخت با موفقیت انجام شد");
        } else {
            response.getWriter().println("خطا در تایید پرداخت");
        }
    } else {
        response.setStatus(HttpServletResponse.SC_BAD_REQUEST);
        response.getWriter().println("پارامتر authority یافت نشد");
    }
}

require 'net/http'
require 'uri'
require 'json'

def verify_payment(authority, merchant)
  uri = URI.parse("https://api.sepordeh.com/merchant/invoices/verify/")
  
  http = Net::HTTP.new(uri.host, uri.port)
  http.use_ssl = true
  http.verify_mode = OpenSSL::SSL::VERIFY_NONE
  
  request = Net::HTTP::Post.new(uri.request_uri)
  request.set_form_data({
    "merchant" => merchant,
    "authority" => authority
  })
  
  begin
    response = http.request(request)
    result = JSON.parse(response.body)
    
    if result["status"] == 200
      invoice_id = result["information"]["invoice_id"]
      card_number = result["information"]["card"]
      
      puts "پرداخت با موفقیت انجام شد"
      puts "شماره فاکتور: #{invoice_id}"
      puts "شماره کارت: #{card_number}"
      
      # ذخیره اطلاعات در دیتابیس
      # به‌روزرسانی وضعیت سفارش
      return true
    else
      puts "خطا: #{result['message']}"
      return false
    end
    
  rescue => e
    puts "خطا در ارسال درخواست: #{e.message}"
    return false
  end
end

# استفاده در Rails
class PaymentController < ApplicationController
  def callback
    authority = params[:authority]
    order_id = params[:orderId]
    merchant = "KnIT45OvAnd1584271146:8zN9iO1Y11tg6LVl"
    
    if authority.present?
      if verify_payment(authority, merchant)
        render plain: "پرداخت با موفقیت انجام شد"
      else
        render plain: "خطا در تایید پرداخت"
      end
    else
      render plain: "پارامتر authority یافت نشد", status: :bad_request
    end
  end
end

package main

import (
    "encoding/json"
    "fmt"
    "io/ioutil"
    "net/http"
    "net/url"
)

type VerifyResponse struct {
    Status      int    `json:"status"`
    Message     string `json:"message"`
    Information struct {
        InvoiceID int    `json:"invoice_id"`
        Card      string `json:"card"`
    } `json:"information"`
}

func verifyPayment(authority, merchant string) bool {
    formData := url.Values{
        "merchant":  {merchant},
        "authority": {authority},
    }
    
    resp, err := http.PostForm(
        "https://api.sepordeh.com/merchant/invoices/verify/",
        formData,
    )
    if err != nil {
        fmt.Printf("خطا در ارسال درخواست: %v\n", err)
        return false
    }
    defer resp.Body.Close()
    
    body, err := ioutil.ReadAll(resp.Body)
    if err != nil {
        fmt.Printf("خطا در خواندن پاسخ: %v\n", err)
        return false
    }
    
    var result VerifyResponse
    err = json.Unmarshal(body, &result)
    if err != nil {
        fmt.Printf("خطا در پردازش JSON: %v\n", err)
        return false
    }
    
    if result.Status == 200 {
        invoiceID := result.Information.InvoiceID
        cardNumber := result.Information.Card
        
        fmt.Println("پرداخت با موفقیت انجام شد")
        fmt.Printf("شماره فاکتور: %d\n", invoiceID)
        fmt.Printf("شماره کارت: %s\n", cardNumber)
        
        // ذخیره اطلاعات در دیتابیس
        // به‌روزرسانی وضعیت سفارش
        return true
    } else {
        fmt.Printf("خطا: %s\n", result.Message)
        return false
    }
}

// استفاده در HTTP Handler
func callbackHandler(w http.ResponseWriter, r *http.Request) {
    authority := r.URL.Query().Get("authority")
    orderID := r.URL.Query().Get("orderId")
    merchant := "KnIT45OvAnd1584271146:8zN9iO1Y11tg6LVl"
    
    if authority != "" {
        if verifyPayment(authority, merchant) {
            fmt.Fprintf(w, "پرداخت با موفقیت انجام شد")
        } else {
            fmt.Fprintf(w, "خطا در تایید پرداخت")
        }
    } else {
        http.Error(w, "پارامتر authority یافت نشد", http.StatusBadRequest)
    }
}

دریافت اطلاعات یک فاکتور

آدرس : https://api.sepordeh.com/merchant/invoices/get/

نام پارامتر	وضعیت	نوع داده	نمونه	شرح
merchant	اجباری	string	KnIT45OvAnd1584271146:8zN9iO1Y11tg6LVl	مرچنت را باید در بخش کسب و کارها از داخل پنل بردارید
id	اجباری	string	822340870864896	شناسه فاکتور

Response
CURL
PHP
Python
Node.js
JavaScript
C#
Java
Ruby
GO

{
  "status": 200,
  "message": "loaded successfully",
  "information": {
    "id": "822340870864196",
    "amount": 100000,
    "callback": "http://website.com/callback",
    "phone": "+989121234567",
    "description": "خرید گوشی موبایل",
    "status": "پرداخت شده",
    "status_id": 1,
    "currency": "تومان",
    "business": "نام کسب و کار",
    "card": "639346******5791",
    "ref": "C33C1D8B7E771D80",
    "ip": "1.147.20.16"
  }
}

curl -X POST https://api.sepordeh.com/merchant/invoices/get/ \
-H "Content-Type: application/json" \
-d '{
    "merchant": "KnIT45OvAnd1584271146:8zN9iO1Y11tg6LVl",
    "invoice_id": "822340870864196"
}'

$curl = curl_init();
curl_setopt_array($curl, array(
    CURLOPT_URL => 'https://api.sepordeh.com/merchant/invoices/get/',
    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 => json_encode([
        'merchant' => 'KnIT45OvAnd1584271146:8zN9iO1Y11tg6LVl',
        'invoice_id' => '822340870864196'
    ]),
    CURLOPT_HTTPHEADER => array(
        'Content-Type: application/json'
    ),
));
$response = curl_exec($curl);
curl_close($curl);

$result = json_decode($response);
if ($result->status === 200) {
    $info = $result->information;
    echo "شناسه فاکتور: " . $info->id . "\n";
    echo "مبلغ: " . $info->amount . " " . $info->currency . "\n";
    echo "لینک بازگشت: " . $info->callback . "\n";
    echo "شماره موبایل: " . $info->phone . "\n";
    echo "توضیحات: " . $info->description . "\n";
    echo "وضعیت: " . $info->status . "\n";
    echo "شناسه وضعیت: " . $info->status_id . "\n";
    echo "کسب و کار: " . $info->business . "\n";
    echo "شماره کارت: " . $info->card . "\n";
    echo "شماره پیگیری: " . $info->ref . "\n";
    echo "IP: " . $info->ip . "\n";
}else{
    echo "خطا: " . $result->message();
}

import requests

url = "https://api.sepordeh.com/merchant/invoices/get/"
payload = {
    "merchant": "KnIT45OvAnd1584271146:8zN9iO1Y11tg6LVl",
    "invoice_id": "822340870864196"
}
headers = {'Content-Type': 'application/json'}

response = requests.post(url, headers=headers, json=payload)
result = response.json()

if result['status'] == 200:
    info = result['information']
    print(f"شناسه فاکتور: {info['id']}")
    print(f"مبلغ: {info['amount']} {info['currency']}")
    print(f"لینک بازگشت: {info['callback']}")
    print(f"شماره موبایل: {info['phone']}")
    print(f"توضیحات: {info['description']}")
    print(f"وضعیت: {info['status']}")
    print(f"شناسه وضعیت: {info['status_id']}")
    print(f"کسب و کار: {info['business']}")
    print(f"شماره کارت: {info['card']}")
    print(f"شماره پیگیری: {info['ref']}")
    print(f"IP: {info['ip']}")

const axios = require('axios');

const data = {
    merchant: "KnIT45OvAnd1584271146:8zN9iO1Y11tg6LVl",
    invoice_id: "822340870864196"
};

axios.post('https://api.sepordeh.com/merchant/invoices/get/', data, {
    headers: { 'Content-Type': 'application/json' }
})
.then(function (response) {
    const result = response.data;
    if (result.status === 200) {
        const info = result.information;
        console.log(`شناسه فاکتور: ${info.id}`);
        console.log(`مبلغ: ${info.amount} ${info.currency}`);
        console.log(`لینک بازگشت: ${info.callback}`);
        console.log(`شماره موبایل: ${info.phone}`);
        console.log(`توضیحات: ${info.description}`);
        console.log(`وضعیت: ${info.status}`);
        console.log(`شناسه وضعیت: ${info.status_id}`);
        console.log(`کسب و کار: ${info.business}`);
        console.log(`شماره کارت: ${info.card}`);
        console.log(`شماره پیگیری: ${info.ref}`);
        console.log(`IP: ${info.ip}`);
    }else{
        echo `خطا: ${result.message}`;
    }
})
.catch(function (error) {
    console.log(error);
});

fetch('https://api.sepordeh.com/merchant/invoices/get/', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({
        merchant: 'KnIT45OvAnd1584271146:8zN9iO1Y11tg6LVl',
        invoice_id: '822340870864196'
    })
})
.then(response => response.json())
.then(result => {
    if (result.status === 200) {
        const info = result.information;
        console.log(`شناسه فاکتور: ${info.id}`);
        console.log(`مبلغ: ${info.amount} ${info.currency}`);
        console.log(`لینک بازگشت: ${info.callback}`);
        console.log(`شماره موبایل: ${info.phone}`);
        console.log(`توضیحات: ${info.description}`);
        console.log(`وضعیت: ${info.status}`);
        console.log(`شناسه وضعیت: ${info.status_id}`);
        console.log(`کسب و کار: ${info.business}`);
        console.log(`شماره کارت: ${info.card}`);
        console.log(`شماره پیگیری: ${info.ref}`);
        console.log(`IP: ${info.ip}`);
    }else{
        echo `خطا: ${result.message}`;
    }
})
.catch(error => console.error('Error:', error));

var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Post, "https://api.sepordeh.com/merchant/invoices/get/");
var content = new StringContent(JsonConvert.SerializeObject(new {
    merchant = "KnIT45OvAnd1584271146:8zN9iO1Y11tg6LVl",
    invoice_id = "822340870864196"
}), Encoding.UTF8, "application/json");
request.Content = content;
var response = await client.SendAsync(request);
response.EnsureSuccessStatusCode();

var json = await response.Content.ReadAsStringAsync();
var result = JsonConvert.DeserializeObject<dynamic>(json);

if (result.status == 200)
{
    var info = result.information;
    Console.WriteLine($"شناسه فاکتور: {info.id}");
    Console.WriteLine($"مبلغ: {info.amount} {info.currency}");
    Console.WriteLine($"لینک بازگشت: {info.callback}");
    Console.WriteLine($"شماره موبایل: {info.phone}");
    Console.WriteLine($"توضیحات: {info.description}");
    Console.WriteLine($"وضعیت: {info.status}");
    Console.WriteLine($"شناسه وضعیت: {info.status_id}");
    Console.WriteLine($"کسب و کار: {info.business}");
    Console.WriteLine($"شماره کارت: {info.card}");
    Console.WriteLine($"شماره پیگیری: {info.ref}");
    Console.WriteLine($"IP: {info.ip}");
}

OkHttpClient client = new OkHttpClient();
MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, 
    "{\"merchant\":\"KnIT45OvAnd1584271146:8zN9iO1Y11tg6LVl\",\"invoice_id\":\"822340870864196\"}");
Request request = new Request.Builder()
    .url("https://api.sepordeh.com/merchant/invoices/get/")
    .method("POST", body)
    .addHeader("Content-Type", "application/json")
    .build();
Response response = client.newCall(request).execute();

String json = response.body().string();
JSONObject result = new JSONObject(json);

if (result.getInt("status") == 200) {
    JSONObject info = result.getJSONObject("information");
    System.out.println("شناسه فاکتور: " + info.getString("id"));
    System.out.println("مبلغ: " + info.getInt("amount") + " " + info.getString("currency"));
    System.out.println("لینک بازگشت: " + info.getString("callback"));
    System.out.println("شماره موبایل: " + info.getString("phone"));
    System.out.println("توضیحات: " + info.getString("description"));
    System.out.println("وضعیت: " + info.getString("status"));
    System.out.println("شناسه وضعیت: " + info.getInt("status_id"));
    System.out.println("کسب و کار: " + info.getString("business"));
    System.out.println("شماره کارت: " + info.getString("card"));
    System.out.println("شماره پیگیری: " + info.getString("ref"));
    System.out.println("IP: " + info.getString("ip"));
}

require "uri"
require "json"
require "net/http"

url = URI("https://api.sepordeh.com/merchant/invoices/get/")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Content-Type"] = "application/json"
request.body = JSON.dump({
    "merchant" => "KnIT45OvAnd1584271146:8zN9iO1Y11tg6LVl",
    "invoice_id" => "822340870864196"
})
response = http.request(request)

result = JSON.parse(response.read_body)
if result['status'] == 200
    info = result['information']
    puts "شناسه فاکتور: #{info['id']}"
    puts "مبلغ: #{info['amount']} #{info['currency']}"
    puts "لینک بازگشت: #{info['callback']}"
    puts "شماره موبایل: #{info['phone']}"
    puts "توضیحات: #{info['description']}"
    puts "وضعیت: #{info['status']}"
    puts "شناسه وضعیت: #{info['status_id']}"
    puts "کسب و کار: #{info['business']}"
    puts "شماره کارت: #{info['card']}"
    puts "شماره پیگیری: #{info['ref']}"
    puts "IP: #{info['ip']}"
end

package main

import (
    "encoding/json"
    "fmt"
    "net/http"
    "strings"
)

type InvoiceInfo struct {
    ID          string `json:"id"`
    Amount      int    `json:"amount"`
    Callback    string `json:"callback"`
    Phone       string `json:"phone"`
    Description string `json:"description"`
    Status      string `json:"status"`
    StatusID    int    `json:"status_id"`
    Currency    string `json:"currency"`
    Business    string `json:"business"`
    Card        string `json:"card"`
    Ref         string `json:"ref"`
    IP          string `json:"ip"`
}

type ApiResponse struct {
    Status      int         `json:"status"`
    Message     string      `json:"message"`
    Information InvoiceInfo `json:"information"`
}

func main() {
    url := "https://api.sepordeh.com/merchant/invoices/get/"
    payload := strings.NewReader(`{
        "merchant": "KnIT45OvAnd1584271146:8zN9iO1Y11tg6LVl",
        "invoice_id": "822340870864196"
    }`)
    req, _ := http.NewRequest("POST", url, payload)
    req.Header.Add("Content-Type", "application/json")
    res, _ := http.DefaultClient.Do(req)
    defer res.Body.Close()

    var result ApiResponse
    json.NewDecoder(res.Body).Decode(&result)

    if result.Status == 200 {
        info := result.Information
        fmt.Println("شناسه فاکتور:", info.ID)
        fmt.Println("مبلغ:", info.Amount, info.Currency)
        fmt.Println("لینک بازگشت:", info.Callback)
        fmt.Println("شماره موبایل:", info.Phone)
        fmt.Println("توضیحات:", info.Description)
        fmt.Println("وضعیت:", info.Status)
        fmt.Println("شناسه وضعیت:", info.StatusID)
        fmt.Println("کسب و کار:", info.Business)
        fmt.Println("شماره کارت:", info.Card)
        fmt.Println("شماره پیگیری:", info.Ref)
        fmt.Println("IP:", info.IP)
    }
}

وضعیت‌های فاکتور:

0 = پرداخت نشده (unpaid)
1 = پرداخت شده (paid)
2 = در حال پردازش (inProgress)
3 = برگشت خورده (reversed)

نکته: این API فقط امکان مشاهده فاکتورهای ۲۴ ساعت گذشته را فراهم می‌کند.

آدرس فراخوانی soap

آدرس : https://api.sepordeh.com/merchant/invoices/wsdl/

ایجاد فاکتور

تابع : add(array)

نام پارامتر	وضعیت	نوع داده	نمونه	شرح
merchant	اجباری	string	KnIT45OvAnd1584271146:8zN9iO1Y11tg6LVl	مرچنت را باید در بخش کسب و کارها از داخل پنل بردارید
amount	اجباری	number	150000	مبلغ فاکتور به تومان
currency_id	اجباری	number	1	برای تومان 1 وارد شود
callback	اجباری	string	http://website.com/callback	آدرس بازگشت بعد از اتمام عملیات پرداخت
phone	اختیاری	string	09121234567	شماره موبایل پرداخت کننده
orderId	اختیاری	string	14886	شماره سفارش در سیستم شما (حداکثر 20 رقمی)
description	اختیاری	string	خرید گوشی موبایل	توضیحات در مورد فاکتور
card	اختیاری	string	6037123456789123	محدود کردن شماره کارت پرداخت کننده

Response
PHP
Python
C#
Java

{
    "status": 200,
    "message": "add completed",
    "information": {
        "invoice_id": 4
    }
}


$params = [
    'merchant' => 'KnIT45OvAnd1584271146:8zN9iO1Y11tg6LVl',
    'amount' => 150000,
    'currency_id' => 1,
    'callback' => 'http://website.com/callback',
    'phone' => '09121234567',
    'orderId' => '14886',
    'description' => 'خرید گوشی موبایل',
    'card' => ''
];

try {
    $client = new SoapClient("https://api.sepordeh.com/merchant/invoices/wsdl/");

    $result = $client->add($params)->return;

    if ($result->status == 200) {
        $invoice_id = $result->information->invoice_id;
        echo "فاکتور با موفقیت صادر شد. شماره فاکتور: " . $invoice_id;

        // ارجاع به صفحه پرداخت
        header('Location: https://api.sepordeh.com/merchant/invoices/pay/id:' . $invoice_id, true, 302);
        exit();
    } else {
        echo "خطا: " . $result->message;
    }
} catch (SoapFault $e) {
    echo "خطا در ارتباط با SOAP: " . $e->getMessage();
}

from zeep import Client
import json

params = {
    'merchant': 'KnIT45OvAnd1584271146:8zN9iO1Y11tg6LVl',
    'amount': 150000,
    'currency_id': 1,
    'callback': 'http://website.com/callback',
    'phone': '09121234567',
    'orderId': '14886',
    'description': 'خرید گوشی موبایل',
    'card': ''
}

try:
    client = Client('https://api.sepordeh.com/merchant/invoices/wsdl/')
    
    result = client.service.add(params)
    result = json.loads(result)
    
    if result["status"] == 200:
        invoice_id = result["information"]["invoice_id"]
        print(f"فاکتور با موفقیت ایجاد شد. شماره فاکتور: {invoice_id}")
        
        payment_url = f"https://api.sepordeh.com/merchant/invoices/pay/id:{invoice_id}"
        print(f"آدرس پرداخت: {payment_url}")
    else:
        print(f"خطا: {result['message']}")
        
except Exception as e:
    print(f"خطا در ارتباط با SOAP: {e}")

using System;
using System.ServiceModel;
using System.Collections.Generic;

public class SepordehSoapPayment
{
    public static void CreateInvoice()
    {
        var parameters = new Dictionary<string, object>
        {
            {"merchant", "KnIT45OvAnd1584271146:8zN9iO1Y11tg6LVl"},
            {"amount", 150000},
            {"currency_id", 1},
            {"callback", "http://website.com/callback"},
            {"phone", "09121234567"},
            {"orderId", "14886"},
            {"description", "خرید گوشی موبایل"},
            {"card", ""}
        };
        
        try
        {
            // استفاده از Add Service Reference برای تولید کلاینت
            var client = new SepordehServiceClient();
            string result = client.add(parameters);
            
            var jsonResult = JsonConvert.DeserializeObject<InvoiceResponse>(result);
            
            if (jsonResult.Status == 200)
            {
                int invoiceId = jsonResult.Information.Invoice_Id;
                Console.WriteLine($"فاکتور با موفقیت ایجاد شد. شماره فاکتور: {invoiceId}");
                
                string paymentUrl = $"https://api.sepordeh.com/merchant/invoices/pay/id:{invoiceId}";
                // Response.Redirect(paymentUrl);
            }
            else
            {
                Console.WriteLine($"خطا: {jsonResult.Message}");
            }
        }
        catch (Exception e)
        {
            Console.WriteLine($"خطا در ارتباط با SOAP: {e.Message}");
        }
    }
}

import javax.xml.namespace.QName;
import javax.xml.ws.Service;
import java.net.URL;
import java.util.HashMap;
import java.util.Map;
import org.json.*;

public class SepordehSoapPayment {
    
    public static void createInvoice() {
        Map<String, Object> params = new HashMap<>();
        params.put("merchant", "KnIT45OvAnd1584271146:8zN9iO1Y11tg6LVl");
        params.put("amount", 150000);
        params.put("currency_id", 1);
        params.put("callback", "http://website.com/callback");
        params.put("phone", "09121234567");
        params.put("orderId", "14886");
        params.put("description", "خرید گوشی موبایل");
        params.put("card", "");
        
        try {
            URL wsdlUrl = new URL("https://api.sepordeh.com/merchant/invoices/wsdl/");
            QName serviceName = new QName("http://sepordeh.com/", "SepordehService");
            
            Service service = Service.create(wsdlUrl, serviceName);
            SepordehService port = service.getPort(SepordehService.class);
            
            String result = port.add(params);
            JSONObject jsonResult = new JSONObject(result);
            
            if (jsonResult.getInt("status") == 200) {
                int invoiceId = jsonResult.getJSONObject("information").getInt("invoice_id");
                System.out.println("فاکتور با موفقیت ایجاد شد. شماره فاکتور: " + invoiceId);
                
                String paymentUrl = "https://api.sepordeh.com/merchant/invoices/pay/id:" + invoiceId;
                // response.sendRedirect(paymentUrl);
            } else {
                System.out.println("خطا: " + jsonResult.getString("message"));
            }
            
        } catch (Exception e) {
            System.err.println("خطا در ارتباط با SOAP: " + e.getMessage());
        }
    }
}

ارجاع به صفحه پرداخت

آدرس : https://api.sepordeh.com/merchant/invoices/pay/id:{invoice_id}

مقدار {invoice_id} را با شماره فاکتور دریافتی در مرحله قبل جایگزین کنید.

PHP
Python
C#
Java

// PHP - ریدایرکت به صفحه پرداخت
header('Location: https://api.sepordeh.com/merchant/invoices/pay/id:' . $invoice_id, true, 302);
exit();

# Python - Flask/Django
payment_url = f"https://api.sepordeh.com/merchant/invoices/pay/id:{invoice_id}"
# return redirect(payment_url, code=302)

// C# - ASP.NET
string paymentUrl = $"https://api.sepordeh.com/merchant/invoices/pay/id:{invoiceId}";
return Redirect(paymentUrl);

// Java - Servlet/Spring
String paymentUrl = "https://api.sepordeh.com/merchant/invoices/pay/id:" + invoiceId;
response.sendRedirect(paymentUrl);

بازگشت از صفحه پرداخت

آدرس : http://website.com/callback?authority={authority}&orderId={orderId}

هنگام بازگشت به آدرس callback دو پارامتر authority و orderId ارسال می‌گردد (توسط متد GET)

تایید پرداخت

تابع : verify(array)

نام پارامتر	وضعیت	نوع داده	نمونه	شرح
merchant	اجباری	string	KnIT45OvAnd1584271146:8zN9iO1Y11tg6LVl	مرچنت را باید در بخش کسب و کارها از داخل پنل بردارید
authority	اجباری	string	35684	این مقدار در هنگام بازگشت از صفحه پرداخت به صورت GET ارسال می‌گردد

Response
PHP
Python
C#
Java

{
    "status": 200,
    "message": "paid",
    "information": {
        "invoice_id": 4,
        "card": "6104********4510"
    }
}


$merchant = "KnIT45OvAnd1584271146:8zN9iO1Y11tg6LVl";
$orderId = $_GET["orderId"];

if (isset($_GET["authority"])) {
    try {
        $client = new SoapClient("https://api.sepordeh.com/merchant/invoices/wsdl/");

        $params = [
            'merchant' => $merchant,
            'authority' => $_GET["authority"]
        ];

        $result = $client->verify($params)->return;

        if ($result->status == 200) {
            $invoice_id = $result->information->invoice_id;
            $card_number = $result->information->card;

            echo "پرداخت با موفقیت انجام شد<br>";
            echo "شماره فاکتور: " . $invoice_id . "<br>";
            echo "شماره کارت: " . $card_number . "<br>";

            // ذخیره اطلاعات در دیتابیس
        } else {
            echo "خطا: " . $result->message;
        }
    } catch (SoapFault $e) {
        echo "خطا در ارتباط با SOAP: " . $e->getMessage();
    }
} else {
    echo "پارامتر authority یافت نشد";
}

from zeep import Client
import json

def verify_payment(authority, merchant):
    try:
        client = Client('https://api.sepordeh.com/merchant/invoices/wsdl/')
        
        params = {
            'merchant': merchant,
            'authority': authority
        }
        
        result = client.service.verify(params)
        result = json.loads(result)
        
        if result["status"] == 200:
            invoice_id = result["information"]["invoice_id"]
            card_number = result["information"]["card"]
            
            print("پرداخت با موفقیت انجام شد")
            print(f"شماره فاکتور: {invoice_id}")
            print(f"شماره کارت: {card_number}")
            
            return True
        else:
            print(f"خطا: {result['message']}")
            return False
            
    except Exception as e:
        print(f"خطا در ارتباط با SOAP: {e}")
        return False

# استفاده در Flask
from flask import request

@app.route('/callback')
def payment_callback():
    authority = request.args.get('authority')
    order_id = request.args.get('orderId')
    merchant = "KnIT45OvAnd1584271146:8zN9iO1Y11tg6LVl"
    
    if authority:
        verify_payment(authority, merchant)
        return "Payment processed"
    else:
        return "Authority parameter not found", 400

using System;
using System.ServiceModel;
using System.Collections.Generic;

public class SoapPaymentVerification
{
    public static bool VerifyPayment(string authority, string merchant)
    {
        try
        {
            var parameters = new Dictionary<string, object>
            {
                {"merchant", merchant},
                {"authority", authority}
            };
            
            var client = new SepordehServiceClient();
            string result = client.verify(parameters);
            
            var jsonResult = JsonConvert.DeserializeObject<VerifyResponse>(result);
            
            if (jsonResult.Status == 200)
            {
                int invoiceId = jsonResult.Information.Invoice_Id;
                string cardNumber = jsonResult.Information.Card;
                
                Console.WriteLine("پرداخت با موفقیت انجام شد");
                Console.WriteLine($"شماره فاکتور: {invoiceId}");
                Console.WriteLine($"شماره کارت: {cardNumber}");
                
                return true;
            }
            else
            {
                Console.WriteLine($"خطا: {jsonResult.Message}");
                return false;
            }
        }
        catch (Exception e)
        {
            Console.WriteLine($"خطا در ارتباط با SOAP: {e.Message}");
            return false;
        }
    }
}

import javax.xml.namespace.QName;
import javax.xml.ws.Service;
import java.net.URL;
import java.util.HashMap;
import java.util.Map;
import org.json.*;

public class SoapPaymentVerification {
    
    public static boolean verifyPayment(String authority, String merchant) {
        try {
            URL wsdlUrl = new URL("https://api.sepordeh.com/merchant/invoices/wsdl/");
            QName serviceName = new QName("http://sepordeh.com/", "SepordehService");
            
            Service service = Service.create(wsdlUrl, serviceName);
            SepordehService port = service.getPort(SepordehService.class);
            
            Map<String, Object> params = new HashMap<>();
            params.put("merchant", merchant);
            params.put("authority", authority);
            
            String result = port.verify(params);
            JSONObject jsonResult = new JSONObject(result);
            
            if (jsonResult.getInt("status") == 200) {
                int invoiceId = jsonResult.getJSONObject("information").getInt("invoice_id");
                String cardNumber = jsonResult.getJSONObject("information").getString("card");
                
                System.out.println("پرداخت با موفقیت انجام شد");
                System.out.println("شماره فاکتور: " + invoiceId);
                System.out.println("شماره کارت: " + cardNumber);
                
                return true;
            } else {
                System.out.println("خطا: " + jsonResult.getString("message"));
                return false;
            }
            
        } catch (Exception e) {
            System.err.println("خطا در ارتباط با SOAP: " + e.getMessage());
            return false;
        }
    }
}

دریافت اطلاعات یک فاکتور

تابع : get(array)

نام پارامتر	وضعیت	نوع داده	نمونه	شرح
merchant	اجباری	string	KnIT45OvAnd1584271146:8zN9iO1Y11tg6LVl	مرچنت را باید در بخش کسب و کارها از داخل پنل بردارید
invoice_id	اجباری	string	822340870864196	شناسه فاکتور

Response
PHP
Python
C#
Java

{
  "status": 200,
  "message": "loaded successfully",
  "information": {
    "id": "822340870864196",
    "amount": 100000,
    "callback": "http://website.com/callback",
    "phone": "+989121234567",
    "description": "خرید گوشی موبایل",
    "status": "پرداخت شده",
    "status_id": 1,
    "currency": "تومان",
    "business": "نام کسب و کار",
    "card": "639346******5791",
    "ref": "C33C1D8B7E771D80",
    "ip": "1.147.20.16"
  }
}

$params = [
    'merchant' => 'KnIT45OvAnd1584271146:8zN9iO1Y11tg6LVl',
    'invoice_id' => '822340870864196'
];

try {
    $client = new SoapClient("https://api.sepordeh.com/merchant/invoices/wsdl/");
    $result = $client->get($params)->return;

    if ($result->status === 200) {
        $info = $result->information;
        echo "شناسه فاکتور: " . $info->id . "\n";
        echo "مبلغ: " . $info->amount . " " . $info->currency . "\n";
        echo "وضعیت: " . $info->status . "\n";
        echo "شماره کارت: " . $info->card . "\n";
        echo "شماره پیگیری: " . $info->ref . "\n";
    }else{
        echo "خطا: " . $result->message();
    }
} catch (SoapFault $e) {
    echo "خطا: " . $e->getMessage();
}

from zeep import Client
import json

params = {
    'merchant': 'KnIT45OvAnd1584271146:8zN9iO1Y11tg6LVl',
    'invoice_id': '822340870864196'
}

try:
    client = Client('https://api.sepordeh.com/merchant/invoices/wsdl/')
    result = client.service.get(params)
    result = json.loads(result)
    
    if result['status'] == 200:
        info = result['information']
        print(f"شناسه فاکتور: {info['id']}")
        print(f"مبلغ: {info['amount']} {info['currency']}")
        print(f"وضعیت: {info['status']}")
        print(f"شماره کارت: {info['card']}")
        print(f"شماره پیگیری: {info['ref']}")
except Exception as e:
    print(f"خطا: {e}")

using System;
using System.ServiceModel;
using System.Collections.Generic;

var parameters = new Dictionary<string, object>
{
    {"merchant", "KnIT45OvAnd1584271146:8zN9iO1Y11tg6LVl"},
    {"invoice_id", "822340870864196"}
};

try
{
    var client = new SepordehServiceClient();
    string result = client.get(parameters);
    
    var jsonResult = JsonConvert.DeserializeObject<InvoiceResponse>(result);
    
    if (jsonResult.Status == 200)
    {
        var info = jsonResult.Information;
        Console.WriteLine($"شناسه فاکتور: {info.Id}");
        Console.WriteLine($"مبلغ: {info.Amount} {info.Currency}");
        Console.WriteLine($"وضعیت: {info.Status}");
        Console.WriteLine($"شماره کارت: {info.Card}");
        Console.WriteLine($"شماره پیگیری: {info.Ref}");
    }
}
catch (Exception e)
{
    Console.WriteLine($"خطا: {e.Message}");

}

import org.json.JSONObject;

import javax.xml.namespace.QName;
import javax.xml.ws.Service;
import java.net.URL;
import java.util.HashMap;
import java.util.Map;

public class SepordehGetInvoice {

    private static final String MERCHANT =
            "KnIT45OvAnd1584271146:8zN9iO1Y11tg6LVl";

    private static final String WSDL_URL =
            "https://api.sepordeh.com/merchant/invoices/wsdl/";

    private static final String NAMESPACE =
            "http://sepordeh.com/";

    private static final String SERVICE_NAME =
            "SepordehService";

    public static void getInvoiceInfo() {

        try {

            Map<String, Object> params = new HashMap<>();
            params.put("merchant", MERCHANT);
            params.put("invoice_id", "822340870864196");

            URL wsdlUrl = new URL(WSDL_URL);

            QName qName = new QName(NAMESPACE, SERVICE_NAME);

            Service service = Service.create(wsdlUrl, qName);

            SepordehService port =
                    service.getPort(SepordehService.class);

            String response = port.get(params);

            JSONObject json = new JSONObject(response);

            int status = json.optInt("status");

            if (status == 200) {

                JSONObject info = json.getJSONObject("information");

                System.out.println("شناسه فاکتور: " +
                        info.optString("id"));

                System.out.println("مبلغ: " +
                        info.optInt("amount") + " " +
                        info.optString("currency"));

                System.out.println("وضعیت: " +
                        info.optString("status"));

                System.out.println("شماره کارت: " +
                        info.optString("card"));

                System.out.println("شماره پیگیری: " +
                        info.optString("ref"));

            } else {

                System.out.println("خطا: " +
                        json.optString("message"));
            }

        } catch (Exception e) {

            System.err.println("خطا در دریافت اطلاعات فاکتور:");
            e.printStackTrace();
        }
    }
}

وضعیت‌های فاکتور (status_id):

0: پرداخت نشده (unpaid)
1: پرداخت شده (paid)
2: در حال پردازش (inProgress)
3: برگشت خورده (reversed)

نکته مهم: API فقط امکان مشاهده فاکتورهای ۲۴ ساعت گذشته را فراهم می‌کند.