Dealer Integration API

Required Headers

Hash Generation

$apiKey = 'your_api_key';
$secretKey = 'your_secret_key';
$timestamp = time();

$hash = hash('sha256', $apiKey . $secretKey . $timestamp);

// Headers
$headers = [
    'X-Api-Key: ' . $apiKey,
    'X-Hash: ' . $hash,
    'X-Timestamp: ' . $timestamp,
    'Content-Type: application/json'
];

const crypto = require('crypto');

const apiKey = 'your_api_key';
const secretKey = 'your_secret_key';
const timestamp = Math.floor(Date.now() / 1000);

const hash = crypto
    .createHash('sha256')
    .update(apiKey + secretKey + timestamp)
    .digest('hex');

const headers = {
    'X-Api-Key': apiKey,
    'X-Hash': hash,
    'X-Timestamp': timestamp.toString(),
    'Content-Type': 'application/json'
};

Response Example

{
  "success": true,
  "message": "Welcome, Demo Dealer",
  "dealer_name": "Demo Dealer",
  "payment_methods": {
    "credit_card": "active",
    "eiban": "active",
    "manual_iban": "inactive"
  }
}

Response Parameters

Request Parameters

Response Example

{
  "success": true,
  "message": "Uygun IBAN bulundu.",
  "data": {
    "tracking_code": "DEP-ABC123XYZ-1733312400",
    "bank_name": "Garanti Bankası",
    "account_name": "Ahmet Yılmaz",
    "iban_no": "TR123456789012345678901234",
    "amount": 500.00,
    "formatted_iban": "TR12 3456 7890 1234 5678 9012 34"
  }
}

Request Parameters

Response Example

{
  "success": true,
  "message": "Çekim talebi alındı.",
  "data": {
    "tracking_code": "WDR-XYZ789ABC-1733312400",
    "status": "pending",
    "amount": 250.00,
    "recipient_name": "Mehmet Demir",
    "recipient_iban": "TR987654321098765432109876"
  }
}

Response Example

{
  "success": true,
  "dealer_name": "Demo Dealer",
  "total_eibans": 2,
  "eibans": [
    {
      "id": 1,
      "iban_no": "TR330006100519786457841326",
      "bank_name": "Garanti BBVA",
      "account_name": "Demo Account",
      "wallet_id": "ABC123XYZ",
      "balance": "125000.00",
      "available_balance": "120000.00"
    },
    {
      "id": 2,
      "iban_no": "TR440006200619786457841327",
      "bank_name": "Akbank",
      "account_name": "Demo Account 2",
      "wallet_id": "DEF456UVW",
      "balance": "50000.00",
      "available_balance": "50000.00"
    }
  ]
}

Response Parameters

Query Parameters

Example Request

GET /api/dealer/transactions?wallet_id=ABC123XYZ&start_date=2025-12-01&end_date=2025-12-03&page=1

Response Example

{
  "success": true,
  "dealer_name": "Demo Dealer",
  "wallet_id": "ABC123XYZ",
  "date_range": {
    "start_date": "2025-12-01",
    "end_date": "2025-12-03"
  },
  "pagination": {
    "current_page": 1,
    "per_page": 100,
    "total_records": 250,
    "total_pages": 3,
    "has_more": true
  },
  "transactions": [
    {
      "transactionId": "TXN123456",
      "amount": "1500.00",
      "type": "incoming",
      "description": "EFT Transfer",
      "senderName": "JOHN DOE",
      "senderIban": "TR1234567890123456789012",
      "date": "2025-12-01T14:30:00"
    }
  ]
}

Pagination Response

Error Responses

Request Parameters

Request Example

{
  "wallet_id": "ABC123XYZ",
  "recipient_iban": "TR330006100519786457841326",
  "recipient_name": "JOHN DOE",
  "amount": 1500.00,
  "description": "Withdrawal payment"
}

Success Response

{
  "success": true,
  "message": "Transfer initiated successfully",
  "transfer": {
    "transfer_id": "TRF-ABC123XYZ",
    "status": "pending",
    "amount": "1500.00",
    "recipient_iban": "TR330006100519786457841326",
    "recipient_name": "JOHN DOE",
    "created_at": "2025-12-04T14:30:00"
  }
}

Error Responses

Query Parameters

Example Request

GET /api/dealer/transfer-status?transfer_id=TRF-ABC123XYZ

Response Example

{
  "success": true,
  "dealer_name": "Demo Dealer",
  "transfer": {
    "transfer_id": "TRF-ABC123XYZ",
    "status": "completed",
    "amount": "1500.00",
    "recipient_iban": "TR330006100519786457841326",
    "recipient_name": "JOHN DOE",
    "description": "Withdrawal payment",
    "created_at": "2025-12-04T14:30:00",
    "completed_at": "2025-12-04T14:32:15"
  }
}

Transfer Status Values

Request Parameters

Response Example

{
  "success": true,
  "message": "Payment created successfully",
  "data": {
    "tracking_code": "CC-A1B2C3D4-1733312400",
    "payment_url": "https://payment.gateway.com/pay/abc123",
    "order_id": "CC-20251126-ABC123",
    "amount": 500.00,
    "currency": "TRY"
  }
}

Response Parameters

Callback Headers

Callback Payload Example (Success)

{
  "success": true,
  "tracking_code": "CC-A1B2C3D4-1733312400",
  "order_id": "CC-20251204-XYZ789",
  "status": "success",
  "amount": 500.00,
  "currency": "TRY",
  "customer_name": "John Doe",
  "customer_email": "[email protected]",
  "customer_phone": "+905551234567",
  "status_message": "Payment completed",
  "completed_at": "2025-12-04T14:35:00",
  "timestamp": 1733312400,
  "hash": "abc123..."
}

Callback Payload Example (Failed)

{
  "success": false,
  "tracking_code": "CC-A1B2C3D4-1733312400",
  "order_id": "CC-20251204-XYZ789",
  "status": "failed",
  "amount": 500.00,
  "currency": "TRY",
  "customer_name": "John Doe",
  "error_code": "TIMEOUT",
  "error_message": "Transaction expired after 15 minutes",
  "timestamp": 1733313300,
  "hash": "def456..."
}

Hash Verification (PHP)

$apiKey = 'your_api_key';
$secretKey = 'your_secret_key';
$trackingCode = $payload['tracking_code'];
$status = $payload['status'];
$timestamp = $payload['timestamp'];

$expectedHash = hash('sha256', $apiKey . $secretKey . $trackingCode . $status . $timestamp);

if ($expectedHash === $payload['hash']) {
    // Valid callback
} else {
    // Invalid callback - reject
}

Response Required

Your callback URL must respond with HTTP 200 status:

{
  "success": true
}

Callback Status Values

Configuration Steps

1. Get your site token and secret key from admin panel
2. Configure your website with these credentials
3. Use site-specific endpoints for API requests
4. Monitor integration status in dashboard