راهنمای جامع اتصال به درگاه پرداخت کارت‌گذر

<?php
define('CARDGOZAR_API_KEY', 'YOUR_API_KEY');
define('CARDGOZAR_BASE_URL', 'https://cardgozar.ir');

/**
 * گام ۱: ساخت سفارش و انتقال خریدار به صفحه پرداخت کارت‌گذر
 */
function requestCardGozarPayment($amountRials, $orderId, $callbackUrl, $description = '') {
    $payload = json_encode([
        'amount'       => (int)$amountRials,
        'order_id'     => (string)$orderId,
        'callback_url' => $callbackUrl,
        'description'  => $description ?: "خرید فاکتور $orderId"
    ]);

    $ch = curl_init(CARDGOZAR_BASE_URL . '/api/v1/payments/create/');
    curl_setopt_array($ch, [
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_POST           => true,
        CURLOPT_POSTFIELDS     => $payload,
        CURLOPT_HTTPHEADER     => [
            'Content-Type: application/json',
            'Authorization: Bearer ' . CARDGOZAR_API_KEY
        ],
        CURLOPT_TIMEOUT        => 10
    ]);

    $response = curl_exec($ch);
    $httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
    curl_close($ch);

    $res = json_decode($response, true);
    if ($httpCode === 201 && !empty($res['payment_url'])) {
        // هدایت مستقیم خریدار به صفحه درگاه
        header("Location: " . $res['payment_url']);
        exit;
    }

    throw new Exception($res['error'] ?? 'خطا در اتصال به درگاه کارت‌گذر');
}

/**
 * گام ۲: استعلام و تایید قطعی پرداخت در صفحه callback_url
 */
function verifyCardGozarPayment($orderToken) {
    $ch = curl_init(CARDGOZAR_BASE_URL . '/api/v1/payments/verify/' . urlencode($orderToken) . '/');
    curl_setopt_array($ch, [
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_HTTPHEADER     => [
            'Authorization: Bearer ' . CARDGOZAR_API_KEY
        ],
        CURLOPT_TIMEOUT        => 10
    ]);

    $response = curl_exec($ch);
    $httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
    curl_close($ch);

    $res = json_decode($response, true);
    if ($httpCode === 200 && !empty($res['is_paid'])) {
        return [
            'success'   => true,
            'ref_id'    => $res['ref_id'],
            'amount'    => $res['final_amount_tomans'],
            'card'      => $res['payer_card'],
            'order_id'  => $res['merchant_order_id']
        ];
    }

    return ['success' => false, 'error' => $res['error'] ?? 'پرداخت تایید نشد'];
}
?>

<?php
/**
 * قطعه‌کد اتصال اختصاصی کارت‌گذر در وردپرس (functions.php یا افزونه)
 */
function cardgozar_create_order_wp($order_id, $amount_tomans, $return_url) {
    $api_key = 'YOUR_API_KEY';
    
    $body = wp_json_encode([
        'amount'       => $amount_tomans * 10, // تبدیل تومان به ریال
        'order_id'     => (string)$order_id,
        'callback_url' => $return_url,
        'description'  => "پرداخت سفارش ووکامرس شماره #$order_id"
    ]);

    $response = wp_remote_post('https://cardgozar.ir/api/v1/payments/create/', [
        'headers'     => [
            'Content-Type'  => 'application/json',
            'Authorization' => 'Bearer ' . $api_key,
        ],
        'body'        => $body,
        'timeout'     => 15,
        'data_format' => 'body'
    ]);

    if (is_wp_error($response)) {
        return false;
    }

    $data = json_decode(wp_remote_retrieve_body($response), true);
    if (wp_remote_retrieve_response_code($response) === 201 && !empty($data['payment_url'])) {
        return $data['payment_url'];
    }

    return false;
}
?>

import requests

API_KEY = "YOUR_API_KEY"
BASE_URL = "https://cardgozar.ir"

def create_payment(amount_rials: int, order_id: str, callback_url: str):
    """ایجاد سفارش پرداخت جدید و دریافت لینک درگاه خریدار"""
    headers = {
        "Authorization": f"Bearer {API_KEY}",
        "Content-Type": "application/json"
    }
    payload = {
        "amount": amount_rials,
        "order_id": order_id,
        "callback_url": callback_url,
        "description": f"Invoice {order_id}"
    }
    resp = requests.post(f"{BASE_URL}/api/v1/payments/create/", json=payload, headers=headers, timeout=10)
    if resp.status_code == 201:
        data = resp.json()
        print("Payment Link:", data["payment_url"])
        print("Final Amount:", data["final_amount_tomans"], "Tomans")
        return data["payment_url"]
    raise Exception(resp.json().get("error", "Error creating payment"))

def verify_payment(order_token: str):
    """استعلام و تایید قطعی تراکنش"""
    headers = {"Authorization": f"Bearer {API_KEY}"}
    resp = requests.get(f"{BASE_URL}/api/v1/payments/verify/{order_token}/", headers=headers, timeout=10)
    data = resp.json()
    if resp.status_code == 200 and data.get("is_paid"):
        print("Success! Ref ID:", data["ref_id"], "Payer Card:", data["payer_card"])
        return True, data
    return False, data

const axios = require('axios');

const API_KEY = 'YOUR_API_KEY';
const BASE_URL = 'https://cardgozar.ir';

const client = axios.create({
    baseURL: BASE_URL,
    headers: {
        'Authorization': `Bearer ${API_KEY}`,
        'Content-Type': 'application/json'
    },
    timeout: 10000
});

// ۱. ایجاد تراکنش
async function createOrder(amountRials, orderId, callbackUrl) {
    const res = await client.post('/api/v1/payments/create/', {
        amount: amountRials,
        order_id: orderId,
        callback_url: callbackUrl,
        description: `Order #${orderId}`
    });
    return res.data.payment_url;
}

// ۲. تایید و استعلام
async function verifyOrder(orderToken) {
    const res = await client.get(`/api/v1/payments/verify/${orderToken}/`);
    return res.data; // { is_paid: true, ref_id: '...', ... }
}

package main

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

const apiKey = "YOUR_API_KEY"
const baseURL = "https://cardgozar.ir"

type CreateOrderResponse struct {
    Status     string `json:"status"`
    PaymentURL string `json:"payment_url"`
    OrderToken string `json:"order_token"`
}

func CreateOrder(amountRials int, orderID, callbackURL string) (string, error) {
    payload, _ := json.Marshal(map[string]interface{}{
        "amount":       amountRials,
        "order_id":     orderID,
        "callback_url": callbackURL,
    })

    req, _ := http.NewRequest("POST", baseURL+"/api/v1/payments/create/", bytes.NewBuffer(payload))
    req.Header.Set("Authorization", "Bearer "+apiKey)
    req.Header.Set("Content-Type", "application/json")

    resp, err := http.DefaultClient.Do(req)
    if err != nil {
        return "", err
    }
    defer resp.Body.Close()

    var res CreateOrderResponse
    json.NewDecoder(resp.Body).Decode(&res)
    return res.PaymentURL, nil
}

# ۱. ایجاد سفارش پرداخت (Create Order)
curl -X POST https://cardgozar.ir/api/v1/payments/create/ \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 1000000,
    "order_id": "TEST-101",
    "callback_url": "https://myshop.ir/payment/verify/",
    "description": "خرید تستی درگاه"
  }'

# ۲. استعلام و تایید سفارش (Verify Order)
curl -X GET https://cardgozar.ir/api/v1/payments/verify/ord_a94f1082cba3e47b/ \
  -H "Authorization: Bearer YOUR_API_KEY"

# ۳. استعلام وضعیت زنده برای فرانت‌اند (Live Status)
curl -X GET https://cardgozar.ir/api/v1/payments/status/ord_a94f1082cba3e47b/