Version: 2.1.1
Last Update: 5 Jan 2025

FIXVIP Get Started

Before using the FixVip API, service providers must communicate the IP addresses or IP address blocks to which the requests will be sent to FixVip developers.

The IP address that the service provider should whitelist: 66.29.138.36

FixVip transmits special credentials (siteId, public and private keys) to the merchants it deals with. Merchant will integrate these credentials information to the service provider.

FOR PAYFIX: Deposit and withdrawal, all steps are the same as Papara, the only difference is methodId=1 for Papara, methodId=3 for Payfix.

Deposit Forms

Customer enters the FixVipPay deposit form on the merchant site.

Click on the “Start Processing” button and customer will be redirected to the link like:

https://pay.fixvippanel.com/home?siteId=1&methodId=1&userId=1&transactionId=1&fullname=Mehmet Yılmaz&return_url=https://siteadresi105.com

The rest of the actions is done from FixVipPay website.

If there is a return_url value in the window that opens after the member has completed the process on our side, it is redirected back there. If not, it can close the window and return to your site.


GET PARAMS

Parameter Type info
siteId integer Site spesific id, will provided by FixVipPay (required)
methodId integer ID Number of payment method (required)
Papara: methodId=1
Payfix: methodId=3
Havale: methodId=8
userId string Customer ID who started a transaction on your site (letters, numbers, hyphens and underscores can be used) (required)
transactionId string Transaction ID of your site (letters, numbers, hyphens and underscores can be used) (required)
fullname string Customer name second name and last name who started a transaction on your site (optional)
return_url string Your website url. (optional)

Withdrawal Methods


# Withdrawal Methods Request Example
$parameters = [
    'token'=> 'JLwO64vDbxnpmeLPXzPoEWGJT8B4VZxB',
    "siteId"=> 1,
    "methodId"=> 8
];

$url = 'https://panel.fixvippanel.com/api/withdrawal/methodlist';
$fields_string = http_build_query($parameters);


$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_HEADER, false);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $fields_string);
$response = curl_exec($ch);
curl_close($ch);

$json = json_decode($response);

if ($json->code == 200) {
    $methodList = $json->methods;
    echo print_r($methodList);
} else {
    echo 'Method list request was rejected.';
}

# Response - Error
{
    "status": 0,
    "code": 1083,
    "title": "Bu site işleme kapatılmıştır!",
    "message": "Bu site işleme kapatılmıştır!",
    "type": "error"
}
                
# Response - Success
{
    "status": 1,
    "code": 200,
    "type": "success",
    "methods": [
        {
            "id": 11,
            "name": "Akbank",
            "alt_limit": 200,
            "ust_limit": 50000
        },
        {
            "id": 12,
            "name": "Garanti Bankası",
            "alt_limit": 200,
            "ust_limit": 50000
        },
        {
            "id": 13,
            "name": "İş Bankası",
            "alt_limit": 200,
            "ust_limit": 50000
        },
        {
            "id": 14,
            "name": "Deniz Bank",
            "alt_limit": 200,
            "ust_limit": 50000
        },
        {
            "id": 15,
            "name": "QNB Finansbank",
            "alt_limit": 200,
            "ust_limit": 50000
        }
    ]
}

Before creating a withdrawal request, you can send a request to the address below with the POST method in order to receive and list the withdrawal request methods.

https://panel.fixvippanel.com/api/withdrawal/methodlist


PARAMETERS

Parameter Type info
token string 32-character public key provided from FixVip (required)
siteId integer Site spesific id, will provided by FixVipPay (required)
methodId integer Payment method id (for havale 8) (required)

RESPONSES

code info
200 Success.
1081 All required fields must be filled!
1082 Invalid Api credentials!
1083 This site processing has been closed!
1090 Our service is inactive due to system operation!

Withdrawal Forms


# Example of Withdrawal Request (will create 800,00 TL withrawal request)
$parameters = [
    'token' => 'JLwO64vDbxnpmeLPXzPoEWGJT8B4VZxB',
    'siteId' => 1,
    'userId' => '250a1',
    'transactionId' => '1d-34_dj5',
    'fullname' => 'Mehmet Yılmaz',
    'IDNumber' => 123456789,
    'methodId' => 1,
    'accountNumber' => '8456413254',
    'amount' => 80000
];

$url = 'https://panel.fixvippanel.com/api/withdrawal';
$fields_string = http_build_query($parameters);

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_HEADER, false);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $fields_string);
$response = curl_exec($ch);
curl_close($ch);

$json = json_decode($response);

if ($json->code == 200) {
    echo 'Withdrawal request was received.';
    print_r($json);
} else {
    echo 'Withdrawal request was rejected.';
}
 
# Response - Error
{
    "status": 0,
    "code": 1082,
    "title": "API credentials hatalıdır!",
    "message": "API credentials hatalıdır!",
    "type": "error"
}
 
# Response - Success
{
    "status": 1,
    "code": 200,
    "title": "Çekim talebi oluşturuldu",
    "message": "Çekim talebi oluşturuldu",
    "type": "success"
}

The withdrawal request is processed by sending a request to the address below with the POST method.

https://panel.fixvippanel.com/api/withdrawal

PARAMETERS

Parameter Type info
token string 32-character public key provided from FixVip (required)
siteId integer Site spesific id, will provided by FixVipPay (required)
userId string Customer ID who started a withdrawal on your site (letters, numbers, hyphens and underscores can be used) (required)
transactionId string Withdrawal (Transaction) ID of your site (letters, numbers, hyphens and underscores can be used) (required)
fullname string Customer name second name and last name who started a transaction on your site (required)
IDNumber integer ID number of Customer (gerekli)
methodId integer ID Number of payment method (for papara methodId=1, payfix methodId=3, for havale bank account described in the previous step) (required)
accountNumber string Customer account number (required)
amount integer The amount of the withdrawal to be made by the member who will withdraw from your site multiplied by 100. For example, 100000 must be sent for 1000 TL withdrawal, 80025 must be sent for 800.25 TL withdrawal. (required)

After the request is sent, you will receive a response from us. We only continue in the case of "code": 200. Any response other than "code": 200 means that the transaction has been canceled by us. In this case, you can reject the withdrawal process with the explanation text we have sent, or leave it in new status. If it is "code": 200, you must mark it as processed (pending) and ensure that the request can not be canceled by the member.

RESPONSES

code info
200 Success.
1081 All required fields must be filled!
1082 Invalid Api credentials!
1083 This site processing has been closed!
1084 This site is not allowed to use the selected method!
1085 This customer has been blocked!
1086 This transaction has already been submitted!
1087 The withdrawal amount is lower than the minimum withdrawal limit allowed for the site!
1088 The withdrawal amount is higher than the maximum withdrawal limit allowed for the site!
1089 Payment method is temporarily disabled!
1090 Our service is inactive due to system operation!

Deposit Callback


 # Deposit Callback - Success Example (Amount: 500 TL)
 {
     "token": "1ao24unjen23482bdfhbhjds",
     "hash": "CTtMyigG29l6e6YyzCRJJBdYNz9NuoLXP8/DGryuqXQ=",
     "type": "d",
     "siteId": 1,
     "userId": "2501",
     "transactionId": "516",
     "fullname": "Mehmet Yılmaz",
     "fixvipId": 1,
     "methodName": "Pep",
     "methodId": 2,
     "status": 1,
     "amount": 50000
 }
 
 # Deposit Callback - Success With Different Amount (Confirmed Amount: 300 TL)
 {
     "token": "1ao24unjen23482bdfhbhjds",
     "hash": "1ZH6QbORnxqLQi3qT2K2isF6lPQ8ZZ7tIrVNQRpd58w=",
     "type": "d",
     "siteId": 1,
     "userId": "2501",
     "transactionId": "518",
     "fullname": "Mehmet Yılmaz",
     "fixvipId": 3,
     "methodName": "Papara",
     "methodId": 1,
     "status": 2,
     "amount": 30000
 }
 
 # Deposit Callback - Rejected Deposit Example (Amount: 127,50 TL)
 {
     "token": "1ao24unjen23482bdfhbhjds",
     "hash": "T2omkisvJwVCmk6hfY64vm2F+CBUgf3NtJKZr+ku8jM=",
     "type": "d",
     "siteId": 1,
     "userId": "2501",
     "transactionId": "517",
     "fullname": "Mehmet Yılmaz",
     "fixvipId": 2,
     "methodName": "Papara",
     "methodId": 1,
     "status": 0,
     "amount": 12725
 }

After the deposit process is checked by us, it will be finalized and a callback will be sent to you by POST method.

PARAMETERS (method: Post)

Parameter Type Info
api credentials All api credentials information you will forward to us will be transmitted in the types you provide.
hash string Hashed data for the reliability of the data transmitted to you. The encryption method of this data is as follows: base64_encode(hash_hmac('sha256', "siteId|userId|private_key|transactionId|fixvipId|amount", private_key, true));
type string 'd' for Deposits, 'w' for Withdrawals
siteId integer Site spesific id, will provided by FixVipPay
userId string Customer ID who started a withdrawal on your site
transactionId string Transaction ID of your site
fullname string Customer name second name and last name who started a transaction on your site
fixvipId integer Transaction ID of FixVipPay
methodName string Method Name (Ex: Papara, Ziraat Bankası)
methodId integer ID of method from FixVip
status integer Result of Deposit (1=success, 2=success with different amount, 0=rejected)
amount integer The amount confirmed as a result of the transaction. This amount is the amount received in our accounts multiplied by 100. In the callbacks sent in approval status with different amounts, the amount for which the transaction was approved by us is sent to you.

CAUTION:
A second callback is sent if the transaction receives a cancellation from us the first time and it is later understood that it has been approved. This second callback includes confirmation or confirmation with a different amount. In any other case, no second callback will be sent for the same transaction.

Withdrawal Callback


 # Withdraw Callback - Success Example (Amount: 800 TL)
 {
     "token": "1ao24unjen23482bdfhbhjds",
     "hash": "rK9RhqSmbsGXTTDDDNibJiT6QQkP3EONMdDESV/KNdg=",
     "type": "w",
     "siteId": 1,
     "userId": "250",
     "transactionId": "124512",
     "fullname": "Mehmet Yılmaz",
     "fixvipId": 1,
     "methodName": "Papara",
     "methodId": 1,
     "status": 1,
     "amount": 80000,
     "note": "onay"
 }
 
 # Withdraw Callback - Rejected Withdraw Example  (Tutar: 1000,50 TL)
 {
     "token": "1ao24unjen23482bdfhbhjds",
     "hash": "fT3SOEcXpJEc1VKks/m9miNGxkxFoXOW2t7NQ1RymYM=",
     "type": "w",
     "siteId": 1,
     "userId": "250",
     "transactionId": "124513",
     "fullname": "Mehmet Yılmaz",
     "fixvipId": 2,
     "methodName": "Pep",
     "methodId": 2,
     "status": 0,
     "amount": 100050,
     "note": "Hesap Numarası ve İsim Uyuşmamakta"
 }

The withdrawal process will be finalized after being checked by us and a callback will be sent to you with the POST method.

PARAMETERS (method: Post)

Parameter Type Info
api credentials All api credentials information you will forward to us will be transmitted in the types you provide.
hash string Hashed data for the reliability of the data transmitted to you. The encryption method of this data is as follows: base64_encode(hash_hmac('sha256', "siteId|userId|private_key|transactionId|fixvipId|amount", private_key, true));
type string 'd' for Deposits, 'w' for Withdrawals
siteId integer Site spesific id, will provided by FixVipPay
userId string Customer ID who started a withdrawal on your site
transactionId string Transaction ID of your site
fullname string Customer name second name and last name who started a transaction on your site
fixvipId integer Transaction ID of FixVipPay
methodName string Method Name (Ex: Papara, Ziraat Bankası)
methodId integer ID of method from FixVip
status integer Result of Withdrawal (1=success,0=rejected)
amount integer The amount of withdrawal approved as a result of the transaction multiplied by 100.
note string Cancellation reason for canceled transactions. In case of approval, it will be sent blank.

CAUTION:
In withdrawal request callbacks, a single callback is sent in case of both confirmation and cancellation..

Logos & Images

SVG

PNG Light Background

PNG Dark Background

PNG Icon