API Integration Guide
Welcome to the API Documentation. This comprehensive guide will help you integrate with our payment processing system.
Base URL
https://www.enigmapay.net/api/dealer
All API requests require authentication using API Key and Secret Key.
Important Update
Authentication system has been updated. Use API Key and Secret Key instead of email/password.
| Header | Value |
|---|---|
X-API-Key |
Your API Key |
X-Hash |
SHA-256 hash of API Key + Secret Key |
Accept |
application/json |
Content-Type |
application/json |
$apiKey = 'your_api_key';
$secretKey = 'your_secret_key';
$hash = hash('sha256', $apiKey . $secretKey);
Get dealer configuration and status information.
/api/dealer/settings
{
"success": true,
"data": {
"credit_card": {
"status": "Aktif",
"commission": "3.50"
},
"eiban": {
"status": "Aktif",
"deposit_commission": "0.00",
"withdrawal_commission": "0.00",
"withdrawal_fee": "0.00"
},
"manual_iban": {
"status": "Aktif",
"deposit_commission": "0.00"
}
},
"info": "Connection successful"
}
| Parameter | Description |
|---|---|
credit_card.status |
Credit card status (Active/Inactive) |
credit_card.commission |
Credit card commission rate (%) |
eiban.status |
E-IBAN status (Active/Inactive) |
eiban.deposit_commission |
Deposit commission (%) |
eiban.withdrawal_commission |
Withdrawal commission (%) |
manual_iban.status |
Manual IBAN status (Active/Inactive) |
Get assigned IBAN information with current balance.
Important Information
Balance data is updated every minute. Multiple requests within a minute won't provide more current data.
/api/dealer/ibans
{
"success": true,
"data": [
{
"id": 1,
"iban": "TR330006100519786457841326",
"owner_name": "John Doe",
"bank_name": "Sample Bank",
"status": "Active",
"balance": 125000.00,
"formatted_balance": "125,000.00 ₺"
}
]
}
Query transaction history for specific IBAN.
/api/dealer/transactions
| Parameter | Type | Required | Description |
|---|---|---|---|
iban_id |
integer | Yes | IBAN ID |
start_date |
date | No | Start date (Y-m-d) |
end_date |
date | No | End date (Y-m-d) |
Initiate money transfer to customer IBAN.
/api/dealer/send-money
| Parameter | Type | Required | Description |
|---|---|---|---|
username |
string | Yes | Customer username |
amount |
decimal | Yes | Transfer amount |
customer_iban |
string | Yes | Customer IBAN |
customer_name |
string | Yes | Account holder name |
description |
string | No | Transfer description |
{
"username": "user123",
"amount": 500.00,
"customer_iban": "TR330006100519786457841326",
"customer_name": "John Doe",
"description": "Withdrawal request"
}
Check status of a previously created transaction.
/api/dealer/transaction-status
| Parameter | Type | Required | Description |
|---|---|---|---|
transaction_id |
integer | Yes | Transaction ID |
{
"success": true,
"data": {
"id": 123,
"status": "Completed",
"amount": 500.00,
"created_at": "2025-11-26 14:30:00",
"completed_at": "2025-11-26 14:35:00"
}
}
Create credit card payment for customer.
Important
Credit card feature must be enabled for your dealer account. Contact support to activate.
/api/dealer/credit-card/payment
| Parameter | Type | Required | Description |
|---|---|---|---|
username |
string | Yes | Customer username |
firstname |
string | Yes | First name |
lastname |
string | Yes | Last name |
email |
Yes | Email address | |
phone |
string | Yes | Phone number |
amount |
decimal | Yes | Payment amount (min: 200 TL) |
description |
string | No | Payment description |
{
"success": true,
"message": "Payment created successfully",
"data": {
"payment_url": "https://payment.gateway.com/pay/abc123",
"order_id": "CC-20251126-ABC123",
"transaction_id": 456,
"amount": 500.00,
"currency": "TRY"
}
}
Receive real-time notifications for transaction status updates.
How it Works
When transaction status changes, we send HTTP POST request to your callback URL with transaction details.
{
"transaction_id": 123,
"status": "Completed",
"amount": 500.00,
"username": "user123",
"description": "Withdrawal",
"completed_at": "2025-11-26 14:35:00"
}
Your callback URL must respond with HTTP 200 status to confirm receipt:
{
"success": true
}
Alternative integration method for your website.
What is Site Integration?
Site integration allows your website to communicate with our API using a secure token and secret key.
Our support team is available 24/7 to assist you with integration questions, troubleshooting, and best practices.