Bankaya Para Transferi

iqmoney hesabınızdan bankaya gerçekleştirilecek para transferi içindir. Müşterilerinizin banka hesaplarına para transferi işlemi gerçekleştirebilirsiniz. API, banka verilerine bir veya daha fazla para çekme işlemi için kullanılabilir.

Method	URL	İçerik-Türü
Post	/api/cashout/tobank	application/json

URL

URL
https://app.iqmoneytr.com/ccpayment/api/cashout/tobank

Parametreler

Tür	Parametreler	Data Türü	Şart
HEADER	Authorization	string	Zorunlu
HEADER	Accept	string	Zorunlu
HEADER	Content-Type	string	Zorunlu
KEY	merchant_key	string	Zorunlu
KEY	hash_key	string	Zorunlu
KEY	cashout_type	int	Zorunlu
KEY	cashout_data	array of objects	Zorunlu
KEY	unique_id	string	Opsiyonel
KEY	name_surname	string	Zorunlu
KEY	iban	string	Zorunlu
KEY	name_of_bank	string	Opsiyonel
KEY	amount	int	Zorunlu
KEY	currency	string	Zorunlu
KEY	id_tc_kn	string	Opsiyonel
KEY	gsm_number	string	Zorunlu
KEY	description	string	Opsiyonel

Authorization

Authorization bağlantı girişimine izin verildiğini doğrulayan bir başlık anahtarıdır. Method “Bearer” olmalıdır.

Örnek Veri


	Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImp0aSI6ImRlMGVlZ
GFiZjdhZDhkODYzYTgyMzQ4Nzk5NTFkYzFlMDZkZTUxYjU0NWRjYm
U3MzRjMmQ1OGNkMWFlOWE4YjliZTkyMjdlZGVmZDdlMDliIn0.eyJhdW
QiOiIxNSIsImp0aSI6ImRlMGVlZGFiZjdhZDhkODYzYTgyMzQ4Nzk5NTFkYzFlMD
ZkZTUxYjU0NWRjYmU3MzRjMmQ1OGNkMWFlOWE4YjliZTkyMjdlZGVmZDdlMD
liIiwiaWF0IjoxNTczNzUyNDcyLCJuYmYiOjE1NzM3NTI0NzIsImV4cCI6MTYwNTM3
NDg3Miwic3ViIjoiMSIsInNjb3BlcyI6W119.mDtdzcv15p8SnYjZYJUJrhdskO5NohXbkc
AxKWWZ72lNtrg86RZ1yxQwfQlRu6IPoa1rfG3M4jfsNeH-Sh7g6PaVffIoKvjdcUG7Cc2lL
qhE4qMEdPgO28luCMOFf6UHn6XxeEhK3XWaboZJvrubdeb0t04a6btrdHUa-FgeV6I8bNSRlzUjOjBcsVrd1pxKhKnsREFHCWfzYVC_ZQ4RRCi9CZsJGz7_KQ8mo0Bd
NmtbNKwfvYkpcdsmVicsJYvnw7OMZ3u-TorhakndhQkUK0JPAzl_LSHqAKCju8dTG1-vZjbh
9ifRB85TGwW4HimQk46RPG9Hp6kydLnuhFOkbvGpaxcs5qyZ67-cmjDa6aeGNjZHfNa7dQ8
bTokdbkxqwKrVVUUVjgkMtPXhpL9yffaHHPNBCkc-1Vz40nsmNFeaoWlk2S7fDxFTcGYv8HFFiSRyfsPpfTbXPI
RMoZUX1kC4cDMyQmjuBqtxIwEFzJexs9PkZEUze5Qcm_ZrkqeKUlL4tJidO9ZzwfCI9bpihMATHlDy
M6IP7XyhgMRt3yr2WvzxuxavqSyu09YlybYU0WpTUtDVOavL7xnuKBXhwDSoCjtCMh__tL9ZfK9lDvq6
mrHQ5Z4RXLixvWMbl98_Btbnfg_SqnCNYwL14FSHyeb3lnuF8VFyERwbf-tAlI

Acceept

Accept ,müşteri tarafında ne tür bir temsilin istendiğini belirler. Değer "application / json" olmalıdır.

Content-Type

Content-Type, sunucu tarafında ne tür bir temsilin istendiğini belirler.. Değer “application / JSON” olmalıdır

merchant_key

merchant_key iqmoney tarafından sağlanan üye işyerinin benzersiz anahtarıdır

hash_key

hash_key hash_key aşağıdaki özel algoritma vasıtasıyla oluşturulur;


	private function generateCashOutAPIHashKey($sum_of_amount_column, $first_row_iban,
$first_row_amount, $first_row_currency, $first_row_gsm, $app_secret ){

    //remove plus(+) sign from gsm number.
    $data = $sum_of_amount_column.'|'.$first_row_iban.'|'.$first_row_amount.'|'.$first_row_currency.'|'.$first_row_gsm;

    $iv = substr(sha1(mt_rand()), 0, 16);
    $password = sha1($app_secret);

    $salt = substr(sha1(mt_rand()), 0, 4);
    $saltWithPassword = hash('sha256', $password . $salt);

    $encrypted = openssl_encrypt(
        "$data", 'aes-256-cbc', "$saltWithPassword", null, $iv
    );
    $msg_encrypted_bundle = "$iv:$salt:$encrypted";
    $hash_key = str_replace('/', '__', $msg_encrypted_bundle);
    return $hash_key;
}

Post İsteği Parametresi


    
  {
    "merchant_key": "$2y$10$w/ODdbTmfubcbUCUq/ia3OoJFMUmkM1UVNBiIQIuLfUlPmaLUT1he",
    "hash_key": "5c4ba833474917d0:fd30:sHw__XC+wersHg4WfL14dNjoe6knYV6Di3Xj0hKy439POpEsmcnJ32jdWU9laeWI3",
    "cashout_type": 1,
    "cashout_data": [
        [
            {
                "unique_id": "6182458",
                "name_surname": "John Doe",
                "iban": "TR150006247004881217621234",
                "name_of_bank": "Türkiye Cumhuriyeti Ziraat Bankası A.ş.",
                "amount": 10,
                "currency": "TRY",
                "id_tc_kn": "12345636268",
                "gsm_number": "901111137653",
                "description": "Description"
            }
        ], [
            {
                "name_surname": "Another Name",
                "iban": "TR150006247004881217621234",
                "amount": 20,
                "currency": "TRY",
                "id_tc_kn": "12345636268",
                "gsm_number": "901111137653",
                "description": "New Description"
            }
        ]

Başarısız Yanıt


   {
    "statuscode": 14,
    "description": "Merchant not found",
    "data": [],
    "status_code": 14,
    "status_description": "Merchant not found"
}

Kısmi Yanıt


  {
    "statuscode": 100,
    "description": "Successful 1 out of 2",
    "data": [
        {
            "unique_id": "8402133",
            "response_code": 100,
            "response_message": "SUCCESS",
            "merchant commission": 2.1,
            "receiver commission": 2.1
},
        {
            "response_code": 2,
            "response_message": "Insufficient balance. Please, try again"
        }
    ] ,
    "status_code": 100,
    "status_description": "Successful 1 out of 2"
}

Başarılı Yanıt


  {
    "statuscode": 100,
    "description": "SUCCESS",
    "data": [
        {
            "unique_id": "8402133",
            "response_code": 100,
            "response_message": "SUCCESS",
            "merchant commission": 2.1,
            "receiver commission": 2.1
},
        {
            "unique_id": "8402133",
            "response_code": 100,
            "response_message": "SUCCESS",
            "merchant commission": 4.2,
            "receiver commission": 4.2
        }
    ] ,
    "status_code": 100,
    "status_description": "SUCCESS"
}

Başarısız Yanıt


   {
    "statuscode": 41,
    "description": "FAILED",
    "data": [
        {
            "response_code": 21,
            "response_message": "Cashout to bank amount can't be less than 10 TRY"
        },
        {
            "response_code": 21,
            "response_message": "Cashout to bank amount can't be less than 10 TRY"
        }
    ],
    "status_code": 41,
    "status_description": "FAILED"
}