Müşteri temsilcisiyle iletişime geç
Nereden başlamalı?
Pay2.House Giriş yap

API

Pay2.House

API anahtarı oluştur

API anahtarı oluşturmak için bağlantıya gidin: https://pay2.house/keys/prepare

İsteklerin yetkilendirilmesi

Pay2.House, API isteklerini yetkilendirmek için JSON Web Tokens (JWT) kullanır.

JSON Web Tokens (JWT) hakkında daha fazla bilgi için JWT token kılavuzunu incelemeniz önerilir.

API ile çalışmak için JSON Web Tokens (JWT) oluşturmanıza ve işlemenize olanak tanıyan bir kütüphane kurmanız gerekir. Aşağıdaki kütüphaneyi kullanmanız önerilir: PHP-JWT

<?php 

    use Firebase\JWT\JWT;
    use Firebase\JWT\Key;
    use phpseclib3\Crypt\RSA;


    function create_token($data = [])
    {
        $private_key    = file_get_contents('pay2_test_private.pem');
        $current_time   = time();

        $payload = [
            'iss'   => 'YOUR_KEY_ID', 
            'iat'   => $current_time,
            'data'  => $data
        ]; 

        return JWT::encode($payload, openssl_pkey_get_private($private_key), 'RS256');
    }

?>

Ödeme oluştur

Bu API yöntemi, Pay2.House ödeme servisi üzerinden ödeme yapmak için yeni bir ödeme başlatmanıza olanak tanır.

Aşağıdaki adrese POST isteği gönderin:
Parametre Tür Açıklama
external_number string Benzersiz işlem veya sipariş numarası.
amount number Ödeme veya işlem tutarı.
currency_code string Ödeme para birimi kodu (örneğin, dolar için USD, euro için EUR, Tether için USDT).
merchant_id string Eklediğiniz merchant kimliği (Merchant ID).
description string Ödeme veya işlem açıklaması.
deadline_seconds number Ödemenin yapılması için zaman aralığını saniye cinsinden belirler (örneğin, 600 değeri 10 dakikalık ödeme süresine karşılık gelir). Maksimum değer 86400 saniyedir (1 gün).
return_url string Ödeme başarıyla tamamlandıktan sonra müşterinin yönlendirileceği URL adresi.
cancel_url string Ödeme iptal edilirse müşterinin yönlendirileceği URL adresi.
handling_fee number Ek ödeme komisyonu.
payer_email string Ödeme işlemiyle ilişkili müşteri e-postası.
payment_method string Bu işlem için kullanılan ödeme yöntemi. Kullanılabilir yöntemler: «PAY2_HOUSE», «USDT_TRC20», «CARDS». Varsayılan değer «ALL» olup, müşterinin ödeme yöntemini kendisinin seçebileceği anlamına gelir.

Yanıt parametreleri:

Parametre Tür Açıklama
status string İsteğin yürütülme durumu (örneğin, başarılı yürütülen istek için "success").
code string Yanıt kodu (örneğin, başarılı istek için "REQUEST_SUCCESS").
invoice_number string Sistemde ödeme işlemini tanımlayan benzersiz fatura numarası.
approval_url string Müşterinin ödemeyi tamamlamak için yönlendirilmesi gereken URL bağlantısı.
<?php 


    function create_payment($request_body = [])
    {
        $curl = curl_init('https://pay2.house/api/create_payment');
        curl_setopt($curl, CURLOPT_POST, TRUE);
        curl_setopt($curl, CURLOPT_POSTFIELDS, http_build_query($request_body));
        curl_setopt($curl, CURLOPT_RETURNTRANSFER, TRUE);
        curl_setopt($curl, CURLOPT_TIMEOUT, 30);
        curl_setopt($curl, CURLOPT_CUSTOMREQUEST, 'POST');
        curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, FALSE);
        curl_setopt($curl, CURLOPT_IPRESOLVE, CURL_IPRESOLVE_V4);
        
        $body = curl_exec($curl);
        $info = curl_getinfo($curl);

        curl_close($curl);

        if ( ! empty($info['http_code']) && $info['http_code'] === 200) {
            return json_decode($body, TRUE);
        }
    }


    $sign_token = create_token([
        'external_number'   => '10001',
        'amount'            => 1000,
        'currency_code'     => 'USD',
        'payment_method'    => 'ALL',
        'merchant_id'       => 'SN6829106944',
        'description'       => 'Payment for Merchant.Name',
        'deadline_seconds'  => 600,
        'handling_fee'      => 10,
        'payer_email'       => '[email protected]',
        'return_url'        => 'https://mysite.com/result',
        'cancel_url'        => 'https://mysite.com/cancel',
    ]);

    
    $api_response = create_payment(['sign_token' => $sign_token, 'api_key' => 'YOUR_API_KEY']);
    if ( ! empty($api_response['approval_url'])) {
        header('Location: ' . $api_response['approval_url'], TRUE, 302);
    }

?>

Ödeme bilgisi

Bu API yöntemi, Pay2.House ödeme sistemindeki ödemeniz hakkında bilgi sorgulamanıza olanak tanır.

Aşağıdaki adrese POST isteği gönderin:
Parametre Tür Açıklama
merchant_id string Eklediğiniz merchant kimliği (Merchant ID).
invoice_number string Fatura numaranız.

Yanıt parametreleri:

Parametre Tür Açıklama
status string İsteğin yürütülme durumu (örneğin, başarılı yürütülen istek için "success").
code string Yanıt kodu (örneğin, başarılı istek için "REQUEST_SUCCESS").
invoice_number string Sistemde ödeme işlemini tanımlayan benzersiz fatura numarası.
currency_code string Ödeme para birimi kodu (örneğin, dolar için USD, euro için EUR, Tether için USDT).
currency_symbol string Para birimi sembolü (örneğin, ABD doları için "$").
external_number string Ödeme işlemiyle ilişkili harici numara.
description string Ödeme işlemi veya fatura açıklaması.
amount number Belirtilen para birimindeki ödeme tutarı.
handling_fee number Ödeme işleme komisyonu tutarı.
payment_status string

Ödeme durumu.

Ödeme bekleniyor: pending

İşleniyor: in_processing

Ödendi: paid

İptal edildi: cancelled

Süresi doldu: overdue

Kısmen ödendi: partially

Ödeme hatası: error

Para iadesi: refunded
<?php 


    function show_payment_details($request_body = [])
    {
        $curl = curl_init('https://pay2.house/api/show_payment_details');
        curl_setopt($curl, CURLOPT_POST, TRUE);
        curl_setopt($curl, CURLOPT_POSTFIELDS, http_build_query($request_body));
        curl_setopt($curl, CURLOPT_RETURNTRANSFER, TRUE);
        curl_setopt($curl, CURLOPT_TIMEOUT, 30);
        curl_setopt($curl, CURLOPT_CUSTOMREQUEST, 'POST');
        curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, FALSE);
        curl_setopt($curl, CURLOPT_IPRESOLVE, CURL_IPRESOLVE_V4);
        
        $body = curl_exec($curl);
        $info = curl_getinfo($curl);

        curl_close($curl);

        if ( ! empty($info['http_code']) && $info['http_code'] === 200) {
            return json_decode($body, TRUE);
        }
    }


    $sign_token = create_token([
        'merchant_id'       => 'SN6829106938',
        'invoice_number'    => 'IN9036982986'
    ]);

    
    $api_response = show_payment_details(['sign_token' => $sign_token, 'api_key' => 'YOUR_API_KEY']);
    if ( ! empty($api_response['status'])) {

        if ($api_response['status'] == 'success') {
            echo 'Amount: ' . $api_response['amount'] . '<br />';
            echo 'Fee: ' . $api_response['handling_fee'] . '<br />';
            echo 'Currency Code: ' . $api_response['currency_code'] . '<br />';
        } else {
            echo 'Error Code: ' . $api_response['code'] . '<br />';
            echo 'Error Message: ' . $api_response['msg'] . '<br />';
        }
        
    } else {
        echo 'Unknown Error';
    }

?>

Transfer oluştur

Bu API yöntemi, Pay2.House sisteminde dahili bir hesaba yeni transfer başlatmanıza olanak tanır.

Aşağıdaki adrese POST isteği gönderin:
Parametre Tür Açıklama
sender_account string Gönderen hesabı.
recipient_account string Alıcı hesabı.
amount number Transfer tutarı.
comment string Transfer yorumu.

Yanıt parametreleri:

Parametre Tür Açıklama
status string İsteğin yürütülme durumu (örneğin, başarılı yürütülen istek için "success").
code string Yanıt kodu (örneğin, başarılı istek için "REQUEST_SUCCESS").
transaction_number string Benzersiz transfer numarası.
<?php 


    function transfer_create($request_body = [])
    {
        $curl = curl_init('https://pay2.house/api/transfers/create');
        curl_setopt($curl, CURLOPT_POST, TRUE);
        curl_setopt($curl, CURLOPT_POSTFIELDS, http_build_query($request_body));
        curl_setopt($curl, CURLOPT_RETURNTRANSFER, TRUE);
        curl_setopt($curl, CURLOPT_TIMEOUT, 30);
        curl_setopt($curl, CURLOPT_CUSTOMREQUEST, 'POST');
        curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, FALSE);
        curl_setopt($curl, CURLOPT_IPRESOLVE, CURL_IPRESOLVE_V4);
        
        $body = curl_exec($curl);
        $info = curl_getinfo($curl);

        curl_close($curl);

        if ( ! empty($info['http_code']) && $info['http_code'] === 200) {
            return json_decode($body, TRUE);
        }
    }


    $sign_token = create_token([
        'sender_account'    => 'P2U49984694',
        'recipient_account' => 'P2U93380055',
        'amount'            => 50,
        'comment'           => 'Transfer of funds to the client\'s account.'
    ]);

    
    $api_response = transfer_create(['sign_token' => $sign_token, 'api_key' => 'YOUR_API_KEY']);
    if ( ! empty($api_response['status'])) {

        if ($api_response['status'] == 'success') {
            echo 'Payment successfully processed.';
        } else {
            echo 'Error Code: ' . $api_response['code'] . '<br />';
            echo 'Error Message: ' . $api_response['msg'] . '<br />';
        }
        
    } else {
        echo 'Unknown Error';
    }

?>

Transfer bilgisi

Bu API yöntemi, transfer hakkında durum, tutar, yürütme tarihi ve saati ile diğer ilişkili veriler dahil ayrıntılı bilgi almanıza olanak tanır.

Aşağıdaki adrese POST isteği gönderin:
Parametre Tür Açıklama
transaction_number string Belirli bir transferi tanımlamak için kullanılan benzersiz işlem numarası.

Yanıt parametreleri:

Parametre Tür Açıklama
status string İsteğin yürütülme durumu (örneğin, başarılı yürütülen istek için "success").
code string Yanıt kodu (örneğin, başarılı istek için "REQUEST_SUCCESS").
transaction_number string Benzersiz işlem numarası.
time_created number İşlemin oluşturulma zamanı, Unix timestamp formatında.
date_created string İşlemin oluşturulma tarihi, YYYY-MM-DD formatında.
sender_account string Fon gönderen hesabın numarası.
recipient_account string Fon alıcı hesabın numarası.
amount number İşlemde transfer edilen tutar.
fee_amount number İşlem için alınan komisyon tutarı.
currency_code string İşlem para birimi kodu (örneğin, dolar için USD, euro için EUR, Tether için USDT).
payment_method string

Bu işlem için kullanılan ödeme yöntemi.

Pay2.House: house_money

Push.House: push_house

Cloaking.House: cloaking_house

Capitalist.Net: capitalist

Virtual Card Pay: virtual_card

Visa Card Pay: visa

Tether USDT: tether

SWIFT: swift
confirm_method string

İşlem onay yöntemi.

SMS ile onay: verification_phone

Google Authenticator: verification_code

API üzerinden onay: verification_api

Onaysız: none
payment_type string

Ödeme türü.

Dahili transfer: transfer

Hesap yükleme: refill

Para birimi değişimi: exchange

Fatura oluşturma: invoice

Merchant API: merchant
transaction_type string İşlem türü (incoming - gelen ödeme, withdrawal - çekim).
transaction_status string

İşlem durumu.

İşleniyor: in_processing

Onaylandı: confirmed

Hata: error
comment string İşlem hakkında ek bilgi.
error_message string İşlem başarısız olduysa hata mesajı.
<?php 


    function transfer_details($request_body = [])
    {
        $curl = curl_init('https://pay2.house/api/transfers/details');
        curl_setopt($curl, CURLOPT_POST, TRUE);
        curl_setopt($curl, CURLOPT_POSTFIELDS, http_build_query($request_body));
        curl_setopt($curl, CURLOPT_RETURNTRANSFER, TRUE);
        curl_setopt($curl, CURLOPT_TIMEOUT, 30);
        curl_setopt($curl, CURLOPT_CUSTOMREQUEST, 'POST');
        curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, FALSE);
        curl_setopt($curl, CURLOPT_IPRESOLVE, CURL_IPRESOLVE_V4);
        
        $body = curl_exec($curl);
        $info = curl_getinfo($curl);

        curl_close($curl);

        if ( ! empty($info['http_code']) && $info['http_code'] === 200) {
            return json_decode($body, TRUE);
        }
    }


    $sign_token = create_token([
        'transaction_number' => 'TN4395601712'
    ]);

    
    $api_response = transfer_details(['sign_token' => $sign_token, 'api_key' => 'YOUR_API_KEY']);
    if ( ! empty($api_response['status'])) {
        
        if ($api_response['status'] == 'success') {
            
            echo 'Transaction Number: ' . $api_response['transaction_number'] . '<br />';
            echo 'Status: ' . $api_response['transaction_status'] . '<br />';
            echo 'Time Created: ' . $api_response['time_created'] . '<br />';
            echo 'Date Created: ' . $api_response['date_created'] . '<br />';
            echo 'Sender Account: ' . $api_response['sender_account'] . '<br />';
            echo 'Recipient Account: ' . $api_response['recipient_account'] . '<br />';
            echo 'Amount: ' . $api_response['amount'] . '<br />';
            echo 'Fee Amount: ' . $api_response['fee_amount'] . '<br />';
            echo 'Currency Code: ' . $api_response['currency_code'] . '<br />';
            echo 'Payment Method: ' . $api_response['payment_method'] . '<br />';
            echo 'Confirm Method:  ' . $api_response['confirm_method'] . '<br />';
            echo 'Payment Type: ' . $api_response['payment_type'] . '<br />';
            echo 'Transaction Type: ' . $api_response['transaction_type'] . '<br />';
            echo 'Comment: ' . $api_response['comment'] . '<br />';
            echo 'Error Message: ' . $api_response['error_message'] . '<br />';
            
        } else {
            echo 'Error Code: ' . $api_response['code'] . '<br />';
            echo 'Error Message: ' . $api_response['msg'] . '<br />';
        }

    } else {
        echo 'Unknown Error';
    }

?>

Transfer geçmişi

Bu API yöntemi, tüm gerçekleştirilmiş transferler hakkında bilgi sağlayarak işlem listesini sorgulamanıza olanak tanır.

Aşağıdaki adrese POST isteği gönderin:
Parametre Tür Açıklama
per_page number Bir sayfada gösterilecek kayıt sayısı.
page number Sayfalama için sayfa numarası.
transaction_type string İşlem türüne göre filtre (incoming - gelen ödeme, withdrawal - çekim).
status string

İşlem durumuna göre filtre.

İşleniyor: in_processing

Onaylandı: confirmed

Hata: error
date_range string Tarih aralığına göre seçim filtresi (DD.MM.YYYY - DD.MM.YYYY formatında), ayrıca filtreleme için kullanılır.

Yanıt parametreleri:

Parametre Tür Açıklama
status string İsteğin yürütülme durumu (örneğin, başarılı yürütülen istek için "success").
code string Yanıt kodu (örneğin, başarılı istek için "REQUEST_SUCCESS").
count number İstekle eşleşen toplam işlem sayısı.
transactions array

Her işlem hakkında bilgi içeren işlem nesneleri dizisi (örneğin, tanımlayıcı, durum, bakiye vb.).

Tüm alanların açıklamasını transfer bilgisi bölümünde görün.
<?php 


    function get_transfers($request_body = [])
    {
        $curl = curl_init('https://pay2.house/api/transfers');
        curl_setopt($curl, CURLOPT_POST, TRUE);
        curl_setopt($curl, CURLOPT_POSTFIELDS, http_build_query($request_body));
        curl_setopt($curl, CURLOPT_RETURNTRANSFER, TRUE);
        curl_setopt($curl, CURLOPT_TIMEOUT, 30);
        curl_setopt($curl, CURLOPT_CUSTOMREQUEST, 'POST');
        curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, FALSE);
        curl_setopt($curl, CURLOPT_IPRESOLVE, CURL_IPRESOLVE_V4);
        
        $body = curl_exec($curl);
        $info = curl_getinfo($curl);

        curl_close($curl);

        if ( ! empty($info['http_code']) && $info['http_code'] === 200) {
            return json_decode($body, TRUE);
        }
    }


    $sign_token = create_token([
        'per_page'  => 10,
        'page'      => 1,
        'status'    => 'confirmed'
    ]);

    
    $api_response = get_transfers(['sign_token' => $sign_token, 'api_key' => 'YOUR_API_KEY']);
    if ( ! empty($api_response['status'])) {

        if ($api_response['status'] == 'success') {

            echo 'Count Transactions: ' . $api_response['count'] . '<br />';
        
            if ( ! empty($api_response['transactions'])) {
                foreach($api_response['transactions'] AS $item) {
                    echo '----------------------------------------';
                    echo 'Transaction Number: ' . $item['transaction_number'] . '<br />';
                    echo 'Status: ' . $item['transaction_status'] . '<br />';
                    echo 'Time Created: ' . $item['time_created'] . '<br />';
                    echo 'Date Created: ' . $item['date_created'] . '<br />';
                    echo 'Sender Account: ' . $item['sender_account'] . '<br />';
                    echo 'Recipient Account: ' . $item['recipient_account'] . '<br />';
                    echo 'Amount: ' . $item['amount'] . '<br />';
                    echo 'Fee Amount: ' . $item['fee_amount'] . '<br />';
                    echo 'Currency Code: ' . $item['currency_code'] . '<br />';
                    echo 'Payment Method: ' . $item['payment_method'] . '<br />';
                    echo 'Confirm Method:  ' . $item['confirm_method'] . '<br />';
                    echo 'Payment Type: ' . $item['payment_type'] . '<br />';
                    echo 'Transaction Type: ' . $item['transaction_type'] . '<br />';
                    echo 'Comment: ' . $item['comment'] . '<br />';
                    echo 'Error Message: ' . $item['error_message'] . '<br />';
                    echo '----------------------------------------';
                    echo '<br />';
                }
            } else {
                echo 'No Transactions Found.';
            }
        } else {
            echo 'Error Code: ' . $api_response['code'] . '<br />';
            echo 'Error Message: ' . $api_response['msg'] . '<br />';
        }
        
    } else {
        echo 'Unknown Error';
    }

?>

Hesap listesini al

Bu API yöntemi, Pay2.House sistemindeki hesabınızla ilişkili tüm hesapların listesini sorgulamanıza olanak tanır.

Aşağıdaki adrese POST isteği gönderin:
Parametre Tür Açıklama
delete_flag number Hesap silme bayrağı. 0 değeri aktif hesabı, 1 değeri ise silinmiş veya bloke edilmiş hesabı gösterir.
currency_code string Hesapları filtrelemek için para birimi kodu (örneğin, dolar için "USD", euro için "EUR", Tether için "USDT").

Yanıt parametreleri:

Parametre Tür Açıklama
status string İsteğin yürütülme durumu (örneğin, başarılı yürütülen istek için "success").
code string Yanıt kodu (örneğin, başarılı istek için "REQUEST_SUCCESS").
count number İstekle eşleşen toplam hesap sayısı.
wallets array

Her hesap hakkında bilgi içeren hesap nesneleri dizisi (örneğin, tanımlayıcı, durum, bakiye vb.).

Tüm alanların açıklamasını hesap bilgisi bölümünde görün.
<?php 


    function get_wallets($request_body = [])
    {
        $curl = curl_init('https://pay2.house/api/wallets');
        curl_setopt($curl, CURLOPT_POST, TRUE);
        curl_setopt($curl, CURLOPT_POSTFIELDS, http_build_query($request_body));
        curl_setopt($curl, CURLOPT_RETURNTRANSFER, TRUE);
        curl_setopt($curl, CURLOPT_TIMEOUT, 30);
        curl_setopt($curl, CURLOPT_CUSTOMREQUEST, 'POST');
        curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, FALSE);
        curl_setopt($curl, CURLOPT_IPRESOLVE, CURL_IPRESOLVE_V4);
        
        $body = curl_exec($curl);
        $info = curl_getinfo($curl);

        curl_close($curl);

        if ( ! empty($info['http_code']) && $info['http_code'] === 200) {
            return json_decode($body, TRUE);
        }
    }


    $sign_token = create_token([
        'delete_flag'   => 0,
        'currency_code' => 'USD'
    ]);

    
    $api_response = get_wallets(['sign_token' => $sign_token, 'api_key' => 'YOUR_API_KEY']);
    if ( ! empty($api_response['status'])) {

        if ($api_response['status'] == 'success') {

            echo 'Count Wallets: ' . $api_response['count'] . '<br />';
        
            if ( ! empty($api_response['wallets'])) {
                foreach($api_response['wallets'] AS $item) {
                    echo '----------------------------------------';
                    echo 'Account Number: ' . $item['account_number'] . '<br />';
                    echo 'Name: ' . $item['name'] . '<br />';
                    echo 'Time Created: ' . $item['time_created'] . '<br />';
                    echo 'Date Created: ' . $item['date_created'] . '<br />';
                    echo 'Balance: ' . $item['balance'] . '<br />';
                    echo 'Bonus: ' . $item['bonus'] . '<br />';
                    echo 'Currency Code: ' . $item['currency_code'] . '<br />';
                    echo 'Currency Symbol: ' . $item['currency_symbol'] . '<br />';
                    echo 'Address TRC20: ' . $item['trc20_address'] . '<br />';
                    echo '----------------------------------------';
                    echo '<br />';
                }
            } else {
                echo 'No Wallets Found.';
            }
        } else {
            echo 'Error Code: ' . $api_response['code'] . '<br />';
            echo 'Error Message: ' . $api_response['msg'] . '<br />';
        }
        
    } else {
        echo 'Unknown Error';
    }

?>

Hesap oluştur

Bu API yöntemi, Pay2.House sistemi içinde ödemeler ve işlemler için kullanılabilecek benzersiz hesaplar oluşturmanıza olanak tanır.

Aşağıdaki adrese POST isteği gönderin:
Parametre Tür Açıklama
name string Hesap adı.
currency_code string Ödeme para birimi kodu (örneğin, dolar için USD, euro için EUR, Tether için USDT).

Yanıt parametreleri:

Parametre Tür Açıklama
status string İsteğin yürütülme durumu (örneğin, başarılı yürütülen istek için "success").
code string Yanıt kodu (örneğin, başarılı istek için "REQUEST_SUCCESS").
account_number string Oluşturulan hesap numarası.
<?php 


    function wallet_create($request_body = [])
    {
        $curl = curl_init('https://pay2.house/api/wallets/create');
        curl_setopt($curl, CURLOPT_POST, TRUE);
        curl_setopt($curl, CURLOPT_POSTFIELDS, http_build_query($request_body));
        curl_setopt($curl, CURLOPT_RETURNTRANSFER, TRUE);
        curl_setopt($curl, CURLOPT_TIMEOUT, 30);
        curl_setopt($curl, CURLOPT_CUSTOMREQUEST, 'POST');
        curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, FALSE);
        curl_setopt($curl, CURLOPT_IPRESOLVE, CURL_IPRESOLVE_V4);
        
        $body = curl_exec($curl);
        $info = curl_getinfo($curl);

        curl_close($curl);

        if ( ! empty($info['http_code']) && $info['http_code'] === 200) {
            return json_decode($body, TRUE);
        }
    }


    $sign_token = create_token([
        'name'          => 'Your Wallet Name',
        'currency_code' => 'USD'
    ]);

    
    $api_response = wallet_create(['sign_token' => $sign_token, 'api_key' => 'YOUR_API_KEY']);
    if ( ! empty($api_response['status'])) {

        if ($api_response['status'] == 'success') {
            echo 'Wallet created successfully.';
        } else {
            echo 'Error Code: ' . $api_response['code'] . '<br />';
            echo 'Error Message: ' . $api_response['msg'] . '<br />';
        }
        
    } else {
        echo 'Unknown Error';
    }

?>

Hesap bilgisi

Bu API yöntemi, Pay2.House ödeme sistemindeki hesabınız hakkında bilgi sorgulamanıza olanak tanır.

Aşağıdaki adrese POST isteği gönderin:
Parametre Tür Açıklama
account_number string Hesap numaranız.

Yanıt parametreleri:

Parametre Tür Açıklama
status string İsteğin yürütülme durumu (örneğin, başarılı yürütülen istek için "success").
code string Yanıt kodu (örneğin, başarılı istek için "REQUEST_SUCCESS").
time_created number Hesabın oluşturulma zamanı, Unix timestamp formatında.
date_created string Hesabın oluşturulma tarihi, YYYY-MM-DD formatında.
delete_flag number Silme bayrağı (0 — silinmedi, 1 — silindi).
account_number string Hesap numarası.
currency_code string Hesabın para birimi kodu (örneğin, dolar için USD, euro için EUR, Tether için USDT).
currency_symbol string Para birimi sembolü (örneğin, ABD doları için "$").
name string Hesap adı.
balance number Hesaptaki mevcut bakiye.
bonus number Varsa hesapta kullanılabilir bonus fon tutarı.
trc20_address string Varsa tokenler için TRC-20 adresi.
<?php 


    function wallet_details($request_body = [])
    {
        $curl = curl_init('https://pay2.house/api/wallets/details');
        curl_setopt($curl, CURLOPT_POST, TRUE);
        curl_setopt($curl, CURLOPT_POSTFIELDS, http_build_query($request_body));
        curl_setopt($curl, CURLOPT_RETURNTRANSFER, TRUE);
        curl_setopt($curl, CURLOPT_TIMEOUT, 30);
        curl_setopt($curl, CURLOPT_CUSTOMREQUEST, 'POST');
        curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, FALSE);
        curl_setopt($curl, CURLOPT_IPRESOLVE, CURL_IPRESOLVE_V4);
        
        $body = curl_exec($curl);
        $info = curl_getinfo($curl);

        curl_close($curl);

        if ( ! empty($info['http_code']) && $info['http_code'] === 200) {
            return json_decode($body, TRUE);
        }
    }


    $sign_token = create_token([
        'account_number' => 'P2U49984694'
    ]);

    
    $api_response = wallet_details(['sign_token' => $sign_token, 'api_key' => 'YOUR_API_KEY']);
    if ( ! empty($api_response['status'])) {
        
        if ($api_response['status'] == 'success') {
            echo 'Account Number: ' . $api_response['account_number'] . '<br />';
            echo 'Name: ' . $api_response['name'] . '<br />';
            echo 'Time Created: ' . $api_response['time_created'] . '<br />';
            echo 'Date Created: ' . $api_response['date_created'] . '<br />';
            echo 'Balance: ' . $api_response['balance'] . '<br />';
            echo 'Bonus: ' . $api_response['bonus'] . '<br />';
            echo 'Currency Code: ' . $api_response['currency_code'] . '<br />';
            echo 'Currency Symbol: ' . $api_response['currency_symbol'] . '<br />';
            echo 'Address TRC20: ' . $api_response['trc20_address'] . '<br />';
        } else {
            echo 'Error Code: ' . $api_response['code'] . '<br />';
            echo 'Error Message: ' . $api_response['msg'] . '<br />';
        }

    } else {
        echo 'Unknown Error';
    }

?>

Hesap ekstresi al

Bu API yöntemi, seçilen hesaba ait tüm işlemler ve bakiye değişiklikleri dahil ayrıntılı hesap ekstresi almanıza olanak tanır.

Aşağıdaki adrese POST isteği gönderin:
Parametre Tür Açıklama
account_number string Hesap numaranız.

Yanıt parametreleri:

Parametre Tür Açıklama
status string İsteğin yürütülme durumu (örneğin, başarılı yürütülen istek için "success").
code string Yanıt kodu (örneğin, başarılı istek için "REQUEST_SUCCESS").
download_url string CSV formatında hesap ekstresi dosyasını indirmek için URL.
<?php 


    function wallet_statement($request_body = [])
    {
        $curl = curl_init('https://pay2.house/api/wallets/statement');
        curl_setopt($curl, CURLOPT_POST, TRUE);
        curl_setopt($curl, CURLOPT_POSTFIELDS, http_build_query($request_body));
        curl_setopt($curl, CURLOPT_RETURNTRANSFER, TRUE);
        curl_setopt($curl, CURLOPT_TIMEOUT, 30);
        curl_setopt($curl, CURLOPT_CUSTOMREQUEST, 'POST');
        curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, FALSE);
        curl_setopt($curl, CURLOPT_IPRESOLVE, CURL_IPRESOLVE_V4);
        
        $body = curl_exec($curl);
        $info = curl_getinfo($curl);

        curl_close($curl);

        if ( ! empty($info['http_code']) && $info['http_code'] === 200) {
            return json_decode($body, TRUE);
        }
    }


    $sign_token = create_token([
        'account_number' => 'P2U49984694'
    ]);

    
    $api_response = wallet_statement(['sign_token' => $sign_token, 'api_key' => 'YOUR_API_KEY']);
    if ( ! empty($api_response['status'])) {
        
        if ($api_response['status'] == 'success') {
            header('Location: ' . $api_response['download_url'], TRUE, 302);
        } else {
            echo 'Error Code: ' . $api_response['code'] . '<br />';
            echo 'Error Message: ' . $api_response['msg'] . '<br />';
        }

    } else {
        echo 'Unknown Error';
    }

?>

BIN listesini al

Bu API yöntemi, Pay2.House sisteminde sanal kart çıkarmak için kullanılabilir BIN listesini almanıza olanak tanır.

Aşağıdaki adrese POST isteği gönderin:
Parametre Tür Açıklama
currency_code string BIN para birimi kodu (örneğin, USD, EUR).
country_code string ISO 3166-1 alpha-2 formatında BIN ülke kodu (örneğin, US, HK).
card_type string

Kart türü.

Sanal: virtual

Fiziksel: physical
card_network string

Ödeme sistemi.

Visa: visa

MasterCard: mastercard
card_product_type string

Kart ürün türü.

Kişisel: personal

Standart: standard

Yanıt parametreleri:

Parametre Tür Açıklama
status string İsteğin yürütülme durumu (örneğin, başarılı yürütülen istek için "success").
code string Yanıt kodu (örneğin, başarılı istek için "REQUEST_SUCCESS").
count number İstekle eşleşen toplam BIN sayısı.
bins array Her BIN hakkında bilgi içeren BIN nesneleri dizisi.
bin string Banka Tanımlama Numarası.
currency_code string BIN para birimi kodu (örneğin, USD, EUR).
country_code string ISO 3166-1 alpha-2 formatında BIN ülke kodu (örneğin, US, HK).
card_type string Ödeme sistemi (örneğin, visa, mastercard).
card_product_type string Kart ürün türü (örneğin, standard, personal).
card_tier string Kart seviyesi (örneğin, premium, shared).
verification_required number Doğrulama gerekip gerekmediği (1 — evet, 0 — hayır).
<?php 


    function cards_bins($request_body = [])
    {
        $curl = curl_init('https://pay2.house/api/cards/bins');
        curl_setopt($curl, CURLOPT_POST, TRUE);
        curl_setopt($curl, CURLOPT_POSTFIELDS, http_build_query($request_body));
        curl_setopt($curl, CURLOPT_RETURNTRANSFER, TRUE);
        curl_setopt($curl, CURLOPT_TIMEOUT, 30);
        curl_setopt($curl, CURLOPT_CUSTOMREQUEST, 'POST');
        curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, FALSE);
        curl_setopt($curl, CURLOPT_IPRESOLVE, CURL_IPRESOLVE_V4);
        
        $body = curl_exec($curl);
        $info = curl_getinfo($curl);

        curl_close($curl);

        if ( ! empty($info['http_code']) && $info['http_code'] === 200) {
            return json_decode($body, TRUE);
        }
    }


    $sign_token = create_token([
        'currency_code'     => 'USD',
        'country_code'      => 'HK',
        'card_type'         => 'virtual',
        'card_network'      => 'mastercard',
        'card_product_type' => 'standard',
    ]);


    $api_response = cards_bins(['sign_token' => $sign_token, 'api_key' => 'YOUR_API_KEY']);
    if ( ! empty($api_response['status'])) {

        if ($api_response['status'] == 'success') {

            echo 'Count Bins: ' . $api_response['count'] . '<br />';

            if ( ! empty($api_response['bins'])) {
                foreach($api_response['bins'] AS $item) {
                    echo 'BIN: ' . $item['bin'] . '<br />';
                    echo 'Currency Code: ' . $item['currency_code'] . '<br />';
                    echo 'Country Code: ' . $item['country_code'] . '<br />';
                    echo 'Card Type: ' . $item['card_type'] . '<br />';
                    echo 'Card Network: ' . $item['card_network'] . '<br />';
                    echo 'Card Product Type: ' . $item['card_product_type'] . '<br />';
                    echo 'Card Tier: ' . $item['card_tier'] . '<br />';
                    echo '3DS Support: ' . $item['is_3ds_supported'] . '<br />';
                    echo 'Verification Required: ' . $item['verification_required'] . '<br />';
                    echo '----------------------------------------';
                    echo '<br />';
                }
            } else {
                echo 'No Bins Found.';
            }

        } else {
            echo 'Error Code: ' . $api_response['code'] . '<br />';
            echo 'Error Message: ' . $api_response['msg'] . '<br />';
        }
        
    } else {
        echo 'Unknown Error';
    }

?>

Kart listesini al

Bu API yöntemi, Pay2.House sisteminde hesabınıza çıkarılmış sanal kartların listesini sorgulamanıza olanak tanır.

Aşağıdaki adrese POST isteği gönderin:
Parametre Tür Açıklama
per_page number Bir sayfada gösterilecek kayıt sayısı.
page number Sayfalama için sayfa numarası.
status string

Kart durumuna göre filtre.

Aktif: active

Bloke edilmiş: blocked

Kapalı: closed

Çıkarılmayı bekliyor: awaiting

Yanıt parametreleri:

Parametre Tür Açıklama
status string İsteğin yürütülme durumu (örneğin, başarılı yürütülen istek için "success").
code string Yanıt kodu (örneğin, başarılı istek için "REQUEST_SUCCESS").
count number İstekle eşleşen toplam kart sayısı.
cards array

Her kart hakkında bilgi içeren kart nesneleri dizisi (örneğin, tanımlayıcı, durum, bakiye vb.).

Tüm alanların açıklamasını kart bilgisi bölümünde görün.
<?php 


    function get_cards($request_body = [])
    {
        $curl = curl_init('https://pay2.house/api/cards');
        curl_setopt($curl, CURLOPT_POST, TRUE);
        curl_setopt($curl, CURLOPT_POSTFIELDS, http_build_query($request_body));
        curl_setopt($curl, CURLOPT_RETURNTRANSFER, TRUE);
        curl_setopt($curl, CURLOPT_TIMEOUT, 30);
        curl_setopt($curl, CURLOPT_CUSTOMREQUEST, 'POST');
        curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, FALSE);
        curl_setopt($curl, CURLOPT_IPRESOLVE, CURL_IPRESOLVE_V4);
        
        $body = curl_exec($curl);
        $info = curl_getinfo($curl);

        curl_close($curl);

        if ( ! empty($info['http_code']) && $info['http_code'] === 200) {
            return json_decode($body, TRUE);
        }
    }


    $sign_token = create_token([
        'per_page'  => 10,
        'page'      => 1,
        'status'    => 'active'
    ]);

    
    $api_response = get_cards(['sign_token' => $sign_token, 'api_key' => 'YOUR_API_KEY']);
    if ( ! empty($api_response['status'])) {

        if ($api_response['status'] == 'success') {

            echo 'Count Cards: ' . $api_response['count'] . '<br />';
        
            if ( ! empty($api_response['cards'])) {
                foreach($api_response['cards'] AS $item) {
                    echo '----------------------------------------';
                    echo 'Card Name: ' . $item['card_name'] . '<br />';
                    echo 'Card Number: ' . $item['card_number'] . '<br />';
                    echo 'Card ID: ' . $item['card_id'] . '<br />';
                    echo 'CVV: ' . $item['cvv'] . '<br />';
                    echo 'Expire Date: ' . $item['expiration_date'] . '<br />';
                    echo '3DS Password: ' . $item['password'] . '<br />';
                    echo 'Currency Code: ' . $item['currency_code'] . '<br />';
                    echo 'Currency Symbol: ' . $item['currency_symbol'] . '<br />';
                    echo 'Time Created: ' . $item['time_created'] . '<br />';
                    echo 'Date Created: ' . $item['date_created'] . '<br />';
                    echo 'Time Renewal: ' . $item['time_renewal'] . '<br />';
                    echo 'Date Renewal: ' . $item['date_renewal'] . '<br />';
                    echo 'Email: ' . $item['email'] . '<br />';
                    echo 'Phone Number: ' . $item['phone_number'] . '<br />';
                    echo 'Address Line 1: ' . $item['address_line_1'] . '<br />';
                    echo 'City: ' . $item['city'] . '<br />';
                    echo 'Country Code: ' . $item['country_code'] . '<br />';
                    echo 'Post Code: ' . $item['post_code'] . '<br />';
                    echo 'First Name: ' . $item['first_name'] . '<br />';
                    echo 'Last Name: ' . $item['last_name'] . '<br />';
                    echo 'Sur Name: ' . $item['sur_name'] . '<br />';
                    echo 'Date Birth: ' . $item['date_birth'] . '<br />';
                    echo 'Card Status: ' . $item['card_status'] . '<br />';
                    echo 'Balance: ' . $item['balance'] . '<br />';
                    echo 'Issuance Cost: ' . $item['issuance_cost'] . '<br />';
                    echo 'Renewal Cost: ' . $item['renewal_cost'] . '<br />';
                    echo 'Recharge Cost: ' . $item['recharge_cost'] . '<br />';
                    echo 'Recharge Type: ' . $item['recharge_type'] . '<br />';
                    echo 'Account Refund Cost: ' . $item['account_refund_cost'] . '<br />';
                    echo 'Account Refund Type: ' . $item['account_refund_type'] . '<br />';
                    echo 'Refund Min Amount: ' . $item['refund_min_amount'] . '<br />';
                    echo 'Min Recharge Amount: ' . $item['min_recharge_amount'] . '<br />';
                    echo 'Max Recharge Amount: ' . $item['max_recharge_amount'] . '<br />';
                    echo 'Block Status: ' . $item['block_status'] . '<br />';
                    echo 'Time Blocked: ' . $item['time_blocked'] . '<br />';
                    echo 'Date Blocked: ' . $item['date_blocked'] . '<br />';
                    echo '----------------------------------------';
                    echo '<br />';
                }
            } else {
                echo 'No Cards Found.';
            }
        } else {
            echo 'Error Code: ' . $api_response['code'] . '<br />';
            echo 'Error Message: ' . $api_response['msg'] . '<br />';
        }
        
    } else {
        echo 'Unknown Error';
    }

?>

Kart çıkar

Bu API yöntemi, Pay2.House sisteminde yeni bir sanal kart çıkarmanıza olanak tanır.

Aşağıdaki adrese POST isteği gönderin:
Parametre Tür Açıklama
account_number string Kart çıkarma ücretinin tahsil edileceği hesap numaranız.
first_name string Kart sahibinin adı.
last_name string Kart sahibinin soyadı.
sur_name string Kart sahibinin ikinci adı.
date_birth string Kart sahibinin doğum tarihi, DD.MM.YYYY formatında.
phone_number string Ülke kodu dahil kart sahibinin telefon numarası.
address string Kart sahibinin ikamet adresi.
city string Kart sahibinin ikamet ettiği şehir.
region string Kart sahibinin ikamet ettiği bölge veya eyalet.
post_code string İkamet adresi için posta kodu.
email string Kart sahibinin e-postası.
country_code string ISO 3166-1 alpha-2 standardına göre ülke kodu (örneğin, Amerika Birleşik Devletleri için "US").
bin_number string Kartın Banka Tanımlama Numarası (BIN). Teknik destek biletleri üzerinden talep edilmelidir.
renewal_payment_flag number Bu bayrak, kartta yeterli fon yoksa kart yenileme için fonların ana Pay2.House hesabından çekilip çekilemeyeceğini gösterir (1 - evet, 0 - hayır).

Yanıt parametreleri:

Parametre Tür Açıklama
status string İsteğin yürütülme durumu (örneğin, başarılı yürütülen istek için "success").
code string Yanıt kodu (örneğin, başarılı istek için "REQUEST_SUCCESS").
card_number string Çıkarılan kart numarası.
card_id string Sistemde sonraki işlemler için kullanılan benzersiz kart tanımlayıcısı.
<?php 


    function card_issue($request_body = [])
    {
        $curl = curl_init('https://pay2.house/api/cards/issue');
        curl_setopt($curl, CURLOPT_POST, TRUE);
        curl_setopt($curl, CURLOPT_POSTFIELDS, http_build_query($request_body));
        curl_setopt($curl, CURLOPT_RETURNTRANSFER, TRUE);
        curl_setopt($curl, CURLOPT_TIMEOUT, 30);
        curl_setopt($curl, CURLOPT_CUSTOMREQUEST, 'POST');
        curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, FALSE);
        curl_setopt($curl, CURLOPT_IPRESOLVE, CURL_IPRESOLVE_V4);
        
        $body = curl_exec($curl);
        $info = curl_getinfo($curl);

        curl_close($curl);

        if ( ! empty($info['http_code']) && $info['http_code'] === 200) {
            return json_decode($body, TRUE);
        }
    }


    $sign_token = create_token([
        'account_number'    => 'P2U48633413',
        'first_name'        => 'John',
        'last_name'         => 'Doe',
        'sur_name'          => 'Smith',
        'date_birth'        => '01.01.1991',
        'phone_number'      => '+380990000000',
        'address'           => 'Kyiv, Ukraine',
        'city'              => 'Kyiv',
        'region'            => 'Kyiv',
        'country_code'      => 'UA',
        'post_code'         => '01001',
        'email'             => '[email protected]',
        'bin_number'        => '1122334455667788',
    ]);

    
    $api_response = card_issue(['sign_token' => $sign_token, 'api_key' => 'YOUR_API_KEY']);
    if ( ! empty($api_response['status'])) {

        if ($api_response['status'] == 'success') {
            echo 'Card Number: ' . $api_response['card_number'] . '<br />';
            echo 'Card ID: ' . $api_response['card_id'] . '<br />';
        } else {
            echo 'Error Code: ' . $api_response['code'] . '<br />';
            echo 'Error Message: ' . $api_response['msg'] . '<br />';
        }
        
    } else {
        echo 'Unknown Error';
    }

?>

Kart bilgisi

Bu API yöntemi, kart numarası, durum, çıkarılma tarihi ve diğer ilişkili veriler dahil sanal kart hakkında ayrıntılı bilgi almanıza olanak tanır.

Aşağıdaki adrese POST isteği gönderin:
Parametre Tür Açıklama
card_id string Kart detaylarını almak için kullanılan sistemdeki benzersiz kart tanımlayıcısı.

Yanıt parametreleri:

Parametre Tür Açıklama
status string İsteğin yürütülme durumu (örneğin, başarılı yürütülen istek için "success").
code string Yanıt kodu (örneğin, başarılı istek için "REQUEST_SUCCESS").
card_name string Kart çıkarılırken belirtilen kart adı.
card_number string Çıkarılan kart numarası.
card_id string Sistemdeki benzersiz kart tanımlayıcısı.
cvv string Yetkilendirme için gerekli kart güvenlik kodu.
expiration_date string Kart son kullanma tarihi, MM/YY formatında.
password string Çevrimiçi işlemler sırasında ek güvenlik için 3DS şifresi.
currency_code string Kart işlemleri için kullanılan para birimi kodu.
currency_symbol string Para birimi sembolü (örneğin: $ veya €).
time_created number Kartın oluşturulma zamanı, Unix timestamp formatında.
date_created string Kartın oluşturulma tarihi, YYYY-MM-DD formatında.
date_renewal string Kart yenileme için sonraki tahsilat tarihi, YYYY-MM-DD formatında.
time_renewal number Kart yenileme için sonraki tahsilat zamanı, Unix timestamp formatında.
email string Kart çıkarılırken belirtilen e-posta adresi.
phone_number string Kart çıkarılırken belirtilen telefon numarası.
address_line_1 string Kart çıkarılırken belirtilen ikamet adresi.
city string Kart çıkarılırken belirtilen ikamet şehri.
country_code string ISO 3166-1 alpha-2 standardına göre ülke kodu (örneğin, Amerika Birleşik Devletleri için "US").
first_name string Kart sahibinin adı.
last_name string Kart sahibinin soyadı.
sur_name string Kart sahibinin ikinci adı.
date_birth string Kart sahibinin doğum tarihi, DD.MM.YYYY formatında.
post_code string Posta kodu.
card_status string

Kart durumu.

Aktif: active

Bloke edilmiş: blocked

Kapalı: closed

Çıkarılmayı bekliyor: awaiting
balance number Kartın mevcut bakiyesi.
issuance_cost number Kart çıkarma maliyeti.
renewal_cost number Kart yenileme maliyeti.
recharge_cost number Kart bakiye yükleme komisyonu.
recharge_type string Kart bakiye yükleme komisyonu türü ("fixed" sabit komisyon veya "percent" yüzdesel komisyon olabilir). Komisyon değeri recharge_cost parametresinden alınır.
account_refund_cost number Karttan para iadesi komisyonu.
account_refund_type string Karttan para iadesi komisyonu türü ("fixed" sabit komisyon veya "percent" yüzdesel komisyon olabilir). Komisyon değeri account_refund_cost parametresinden alınır.
refund_min_amount number Karttan minimum para iadesi tutarı.
min_recharge_amount number Minimum kart bakiye yükleme tutarı.
max_recharge_amount number Maksimum kart bakiye yükleme tutarı.
block_status string

Kart bloke durumu.

Olası değerler kart bloke durumları bölümünde bulunabilir.
date_blocked string Kart bloke tarihi, YYYY-MM-DD formatında.
time_blocked number Kart bloke zamanı, Unix timestamp formatında.
<?php 


    function card_details($request_body = [])
    {
        $curl = curl_init('https://pay2.house/api/cards/details');
        curl_setopt($curl, CURLOPT_POST, TRUE);
        curl_setopt($curl, CURLOPT_POSTFIELDS, http_build_query($request_body));
        curl_setopt($curl, CURLOPT_RETURNTRANSFER, TRUE);
        curl_setopt($curl, CURLOPT_TIMEOUT, 30);
        curl_setopt($curl, CURLOPT_CUSTOMREQUEST, 'POST');
        curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, FALSE);
        curl_setopt($curl, CURLOPT_IPRESOLVE, CURL_IPRESOLVE_V4);
        
        $body = curl_exec($curl);
        $info = curl_getinfo($curl);

        curl_close($curl);

        if ( ! empty($info['http_code']) && $info['http_code'] === 200) {
            return json_decode($body, TRUE);
        }
    }


    $sign_token = create_token([
        'card_id' => 'VC7914059264'
    ]);

    
    $api_response = card_details(['sign_token' => $sign_token, 'api_key' => 'YOUR_API_KEY']);
    if ( ! empty($api_response['status'])) {

        if ($api_response['status'] == 'success') {
            echo 'Card Name: ' . $api_response['card_name'] . '<br />';
            echo 'Card Number: ' . $api_response['card_number'] . '<br />';
            echo 'Card ID: ' . $api_response['card_id'] . '<br />';
            echo 'CVV: ' . $api_response['cvv'] . '<br />';
            echo 'Expire Date: ' . $api_response['expiration_date'] . '<br />';
            echo '3DS Password: ' . $api_response['password'] . '<br />';
            echo 'Currency Code: ' . $api_response['currency_code'] . '<br />';
            echo 'Currency Symbol: ' . $api_response['currency_symbol'] . '<br />';
            echo 'Time Created: ' . $api_response['time_created'] . '<br />';
            echo 'Date Created: ' . $api_response['date_created'] . '<br />';
            echo 'Time Renewal: ' . $api_response['time_renewal'] . '<br />';
            echo 'Date Renewal: ' . $api_response['date_renewal'] . '<br />';
            echo 'Email: ' . $api_response['email'] . '<br />';
            echo 'Phone Number: ' . $api_response['phone_number'] . '<br />';
            echo 'Address Line 1: ' . $api_response['address_line_1'] . '<br />';
            echo 'City: ' . $api_response['city'] . '<br />';
            echo 'Country Code: ' . $api_response['country_code'] . '<br />';
            echo 'Post Code: ' . $api_response['post_code'] . '<br />';
            echo 'First Name: ' . $api_response['first_name'] . '<br />';
            echo 'Last Name: ' . $api_response['last_name'] . '<br />';
            echo 'Sur Name: ' . $api_response['sur_name'] . '<br />';
            echo 'Date Birth: ' . $api_response['date_birth'] . '<br />';
            echo 'Card Status: ' . $api_response['card_status'] . '<br />';
            echo 'Balance: ' . $api_response['balance'] . '<br />';
            echo 'Issuance Cost: ' . $api_response['issuance_cost'] . '<br />';
            echo 'Renewal Cost: ' . $api_response['renewal_cost'] . '<br />';
            echo 'Recharge Cost: ' . $api_response['recharge_cost'] . '<br />';
            echo 'Recharge Type: ' . $api_response['recharge_type'] . '<br />';
            echo 'Account Refund Cost: ' . $api_response['account_refund_cost'] . '<br />';
            echo 'Account Refund Type: ' . $api_response['account_refund_type'] . '<br />';
            echo 'Refund Min Amount: ' . $api_response['refund_min_amount'] . '<br />';
            echo 'Min Recharge Amount: ' . $api_response['min_recharge_amount'] . '<br />';
            echo 'Max Recharge Amount: ' . $api_response['max_recharge_amount'] . '<br />';
            echo 'Block Status: ' . $api_response['block_status'] . '<br />';
            echo 'Time Blocked: ' . $api_response['time_blocked'] . '<br />';
            echo 'Date Blocked: ' . $api_response['date_blocked'] . '<br />';
        } else {
            echo 'Error Code: ' . $api_response['code'] . '<br />';
            echo 'Error Message: ' . $api_response['msg'] . '<br />';
        }
        
    } else {
        echo 'Unknown Error';
    }

?>

Kartı yeniden adlandır

Bu API yöntemi, Pay2.House sistemindeki sanal kartın adını değiştirmenizi sağlar.

Aşağıdaki adrese POST isteği gönderin:
Parametre Tür Açıklama
card_id string Kart detaylarını almak için kullanılan sistemdeki benzersiz kart tanımlayıcısı.
name string Sanal kartın yeni adı. Maksimum uzunluk — 100 karakter.

Yanıt parametreleri:

Parametre Tür Açıklama
status string İsteğin yürütülme durumu (örneğin, başarılı yürütülen istek için "success").
code string Yanıt kodu (örneğin, başarılı istek için "REQUEST_SUCCESS").
card_name string Değişiklikten sonraki sanal kart adı.
<?php 


    function card_rename($request_body = [])
    {
        $curl = curl_init('https://pay2.house/api/cards/rename');
        curl_setopt($curl, CURLOPT_POST, TRUE);
        curl_setopt($curl, CURLOPT_POSTFIELDS, http_build_query($request_body));
        curl_setopt($curl, CURLOPT_RETURNTRANSFER, TRUE);
        curl_setopt($curl, CURLOPT_TIMEOUT, 30);
        curl_setopt($curl, CURLOPT_CUSTOMREQUEST, 'POST');
        curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, FALSE);
        curl_setopt($curl, CURLOPT_IPRESOLVE, CURL_IPRESOLVE_V4);
        
        $body = curl_exec($curl);
        $info = curl_getinfo($curl);

        curl_close($curl);

        if ( ! empty($info['http_code']) && $info['http_code'] === 200) {
            return json_decode($body, TRUE);
        }
    }


    $sign_token = create_token([
        'card_id' => 'VC7914059264',
        'name'    => 'New Card Name'
    ]);

    
    $api_response = card_rename(['sign_token' => $sign_token, 'api_key' => 'YOUR_API_KEY']);
    if ( ! empty($api_response['status'])) {

        if ($api_response['status'] == 'success') {
            echo 'Card Name: ' . $api_response['card_name'] . '<br />';
        } else {
            echo 'Error Code: ' . $api_response['code'] . '<br />';
            echo 'Error Message: ' . $api_response['msg'] . '<br />';
        }
        
    } else {
        echo 'Unknown Error';
    }

?>

Kart bakiyesi yükleme

Bu API yöntemi, dahili hesabınızı kullanarak sanal kart bakiyesini yüklemenize olanak tanır.

Bakiye yükleme isteği oluşturulduktan sonra fonlar 2-3 dakika içinde karta aktarılacaktır.

Aşağıdaki adrese POST isteği gönderin:
Parametre Tür Açıklama
card_id string Bakiye yüklemek istediğiniz sanal kartın tanımlayıcısı.
account_number string Bakiye yükleme tutarının tahsil edileceği dahili hesap numaranız.
amount number Sanal karta aktarmak istediğiniz tutar.

Yanıt parametreleri:

Parametre Tür Açıklama
status string İsteğin yürütülme durumu (örneğin, başarılı yürütülen istek için "success").
code string Yanıt kodu (örneğin, başarılı istek için "REQUEST_SUCCESS").
transaction_number string Kart bakiye yükleme ile ilişkili işlem numarası.
<?php 


    function card_top_up($request_body = [])
    {
        $curl = curl_init('https://pay2.house/api/cards/top_up');
        curl_setopt($curl, CURLOPT_POST, TRUE);
        curl_setopt($curl, CURLOPT_POSTFIELDS, http_build_query($request_body));
        curl_setopt($curl, CURLOPT_RETURNTRANSFER, TRUE);
        curl_setopt($curl, CURLOPT_TIMEOUT, 30);
        curl_setopt($curl, CURLOPT_CUSTOMREQUEST, 'POST');
        curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, FALSE);
        curl_setopt($curl, CURLOPT_IPRESOLVE, CURL_IPRESOLVE_V4);
        
        $body = curl_exec($curl);
        $info = curl_getinfo($curl);

        curl_close($curl);

        if ( ! empty($info['http_code']) && $info['http_code'] === 200) {
            return json_decode($body, TRUE);
        }
    }


    $sign_token = create_token([
        'card_id'           => 'VC7914059264',
        'account_number'    => 'P2U48633413',
        'amount'            => 50
    ]);

    
    $api_response = card_top_up(['sign_token' => $sign_token, 'api_key' => 'YOUR_API_KEY']);
    if ( ! empty($api_response['status'])) {
        
        if ($api_response['status'] == 'success') {
            echo 'Transaction Number: ' . $api_response['transaction_number'] . '<br />';
        } else {
            echo 'Error Code: ' . $api_response['code'] . '<br />';
            echo 'Error Message: ' . $api_response['msg'] . '<br />';
        }
        
    } else {
        echo 'Unknown Error';
    }

?>

Karttan para iadesi

Bu API yöntemi, sanal karttan dahili hesabınıza para iadesi başlatmanıza olanak tanır.

Fonlar, kartın çıkarıldığı aynı hesaba iade edilir.

Kart tarifelerine göre iade komisyonu düşüldükten sonra kalan tutarı alırsınız.

Örneğin, $10 iade yaparsanız ve iade komisyonu %3 ise, $10 × %3 = $0.30 komisyon olarak kesilir ve hesabınıza $9.70 aktarılır.

Aşağıdaki adrese POST isteği gönderin:
Parametre Tür Açıklama
card_id string Para iadesinin yapıldığı kartın benzersiz tanımlayıcısı.
amount number Dahili hesaba aktarılması gereken iade tutarı.

Yanıt parametreleri:

Parametre Tür Açıklama
status string İsteğin yürütülme durumu (örneğin, başarılı yürütülen istek için "success").
code string Yanıt kodu (örneğin, başarılı istek için "REQUEST_SUCCESS").
transaction_number string Karttan gerçekleştirilen para iadesiyle ilişkili benzersiz işlem numarası.
<?php 


    function card_refund($request_body = [])
    {
        $curl = curl_init('https://pay2.house/api/cards/refund');
        curl_setopt($curl, CURLOPT_POST, TRUE);
        curl_setopt($curl, CURLOPT_POSTFIELDS, http_build_query($request_body));
        curl_setopt($curl, CURLOPT_RETURNTRANSFER, TRUE);
        curl_setopt($curl, CURLOPT_TIMEOUT, 30);
        curl_setopt($curl, CURLOPT_CUSTOMREQUEST, 'POST');
        curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, FALSE);
        curl_setopt($curl, CURLOPT_IPRESOLVE, CURL_IPRESOLVE_V4);
        
        $body = curl_exec($curl);
        $info = curl_getinfo($curl);

        curl_close($curl);

        if ( ! empty($info['http_code']) && $info['http_code'] === 200) {
            return json_decode($body, TRUE);
        }
    }


    $sign_token = create_token([
        'card_id'   => 'VC7914059264',
        'amount'    => 10
    ]);

    
    $api_response = card_refund(['sign_token' => $sign_token, 'api_key' => 'YOUR_API_KEY']);
    if ( ! empty($api_response['status'])) {

        if ($api_response['status'] == 'success') {
            echo 'Transaction Number: ' . $api_response['transaction_number'] . '<br />';
        } else {
            echo 'Error Code: ' . $api_response['code'] . '<br />';
            echo 'Error Message: ' . $api_response['msg'] . '<br />';
        }
        
    } else {
        echo 'Unknown Error';
    }

?>

Kart işlem geçmişi

Bu API yöntemi, sanal kartınızla gerçekleştirilen tüm işlemlerin tam listesine erişim sağlar.

Aşağıdaki adrese POST isteği gönderin:
Parametre Tür Açıklama
card_id string İşlem geçmişini almak istediğiniz sanal kartın benzersiz tanımlayıcısı.
per_page number Bir sayfada gösterilecek kayıt sayısı.
page number Sayfalama için sayfa numarası.

Yanıt parametreleri:

Parametre Tür Açıklama
status string İsteğin yürütülme durumu (örneğin, başarılı yürütülen istek için "success").
code string Yanıt kodu (örneğin, başarılı istek için "REQUEST_SUCCESS").
count number Bu kartın işlem geçmişindeki toplam işlem sayısı.
transactions array Her işlemin tarih, tutar ve işlem türü dahil detaylarını içeren nesne listesi.
<?php 


    function cards_history($request_body = [])
    {
        $curl = curl_init('https://pay2.house/api/cards/history');
        curl_setopt($curl, CURLOPT_POST, TRUE);
        curl_setopt($curl, CURLOPT_POSTFIELDS, http_build_query($request_body));
        curl_setopt($curl, CURLOPT_RETURNTRANSFER, TRUE);
        curl_setopt($curl, CURLOPT_TIMEOUT, 30);
        curl_setopt($curl, CURLOPT_CUSTOMREQUEST, 'POST');
        curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, FALSE);
        curl_setopt($curl, CURLOPT_IPRESOLVE, CURL_IPRESOLVE_V4);
        
        $body = curl_exec($curl);
        $info = curl_getinfo($curl);

        curl_close($curl);

        if ( ! empty($info['http_code']) && $info['http_code'] === 200) {
            return json_decode($body, TRUE);
        }
    }


    $sign_token = create_token([
        'card_id'   => 'VC7914059264',
        'per_page'  => 10,
        'page'      => 3
    ]);

    
    $api_response = cards_history(['sign_token' => $sign_token, 'api_key' => 'YOUR_API_KEY']);
    if ( ! empty($api_response['status'])) {

        if ($api_response['status'] == 'success') {

            echo 'Count Transactions: ' . $api_response['count'] . '<br />';
        
            if ( ! empty($api_response['transactions'])) {
                foreach($api_response['transactions'] AS $item) {
                    echo 'Transaction Time: ' . $item['transaction_time'] . '<br />';
                    echo 'Transaction Number: ' . $item['transaction_number'] . '<br />';
                    echo 'Status: ' . $item['status'] . '<br />';
                    echo 'Type: ' . $item['type'] . '<br />';
                    echo 'Transaction Amount: ' . $item['transaction_amount'] . '<br />';
                    echo 'Transaction Currency Code: ' . $item['transaction_currency_code'] . '<br />';
                    echo 'Account Amount: ' . $item['account_amount'] . '<br />';
                    echo 'Account Currency Code: ' . $item['account_currency_code'] . '<br />';
                    echo 'Merchant Name: ' . $item['merchant_name'] . '<br />';
                    echo 'Merchant Url: ' . $item['merchant_url'] . '<br />';
                    echo 'Merchant Domain: ' . $item['merchant_domain'] . '<br />';
                    echo 'Merchant Icon Url: ' . $item['merchant_icon_url'] . '<br />';
                    echo 'Error Message: ' . $item['error_message'] . '<br />';
                    echo '----------------------------------------';
                    echo '<br />';
                }
            } else {
                echo 'No Transactions Found.';
            }

        } else {
            echo 'Error Code: ' . $api_response['code'] . '<br />';
            echo 'Error Message: ' . $api_response['msg'] . '<br />';
        }
        
    } else {
        echo 'Unknown Error';
    }

?>

Kart bakiyesini güncelle

Bu API yöntemi, sanal kart bakiyesinin güncellenmesini başlatarak karttaki mevcut fon durumu hakkında güncel veriler alınmasını sağlar.

Aşağıdaki adrese POST isteği gönderin:
Parametre Tür Açıklama
card_id string Bakiyesini güncellemek istediğiniz sanal kartın benzersiz tanımlayıcısı.

Yanıt parametreleri:

Parametre Tür Açıklama
status string İsteğin yürütülme durumu (örneğin, başarılı yürütülen istek için "success").
code string Yanıt kodu (örneğin, başarılı istek için "REQUEST_SUCCESS").
balance number Güncellemeden sonra sanal kartın mevcut bakiyesi, kullanılabilir fonları gösterir.
<?php 


    function card_balance_refresh($request_body = [])
    {
        $curl = curl_init('https://pay2.house/api/cards/balance/refresh');
        curl_setopt($curl, CURLOPT_POST, TRUE);
        curl_setopt($curl, CURLOPT_POSTFIELDS, http_build_query($request_body));
        curl_setopt($curl, CURLOPT_RETURNTRANSFER, TRUE);
        curl_setopt($curl, CURLOPT_TIMEOUT, 30);
        curl_setopt($curl, CURLOPT_CUSTOMREQUEST, 'POST');
        curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, FALSE);
        curl_setopt($curl, CURLOPT_IPRESOLVE, CURL_IPRESOLVE_V4);
        
        $body = curl_exec($curl);
        $info = curl_getinfo($curl);

        curl_close($curl);

        if ( ! empty($info['http_code']) && $info['http_code'] === 200) {
            return json_decode($body, TRUE);
        }
    }


    $sign_token = create_token([
        'card_id' => 'VC7914059264'
    ]);

    
    $api_response = card_balance_refresh(['sign_token' => $sign_token, 'api_key' => 'YOUR_API_KEY']);
    if ( ! empty($api_response['status'])) {

        if ($api_response['status'] == 'success') {
            echo 'Card Balance: ' . $api_response['balance'] . '<br />';
        } else {
            echo 'Error Code: ' . $api_response['code'] . '<br />';
            echo 'Error Message: ' . $api_response['msg'] . '<br />';
        }
        
    } else {
        echo 'Unknown Error';
    }

?>

Kart onay kodları

Bu API yöntemi, sanal kartla yapılan işlemleri yetkilendirmek için gerekli onay kodlarının listesini almanıza olanak tanır.

Aşağıdaki adrese POST isteği gönderin:
Parametre Tür Açıklama
card_id string İşlem onay kodları gereken sanal kartın benzersiz tanımlayıcısı.

Yanıt parametreleri:

Parametre Tür Açıklama
status string İsteğin yürütülme durumu (örneğin, başarılı yürütülen istek için "success").
code string Yanıt kodu (örneğin, başarılı istek için "REQUEST_SUCCESS").
codes array Kart işlemlerini tamamlamak için gerekli onay kodlarının listesi.
<?php 


    function card_confirmation_codes($request_body = [])
    {
        $curl = curl_init('https://pay2.house/api/cards/confirmation_codes');
        curl_setopt($curl, CURLOPT_POST, TRUE);
        curl_setopt($curl, CURLOPT_POSTFIELDS, http_build_query($request_body));
        curl_setopt($curl, CURLOPT_RETURNTRANSFER, TRUE);
        curl_setopt($curl, CURLOPT_TIMEOUT, 30);
        curl_setopt($curl, CURLOPT_CUSTOMREQUEST, 'POST');
        curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, FALSE);
        curl_setopt($curl, CURLOPT_IPRESOLVE, CURL_IPRESOLVE_V4);
        
        $body = curl_exec($curl);
        $info = curl_getinfo($curl);

        curl_close($curl);

        if ( ! empty($info['http_code']) && $info['http_code'] === 200) {
            return json_decode($body, TRUE);
        }
    }


    $sign_token = create_token([
        'card_id' => 'VC7914059264'
    ]);

    
    $api_response = card_confirmation_codes(['sign_token' => $sign_token, 'api_key' => 'YOUR_API_KEY']);
    if ( ! empty($api_response['status'])) {
        
        if ($api_response['status'] == 'success') {

            if ( ! empty($api_response['codes'])) {
                foreach($api_response['codes'] AS $item) {
                    echo 'Time Created: ' . $item['time_created'] . '<br />';
                    echo 'Date Created: ' . $item['date_created'] . '<br />';
                    echo 'Otp Code: ' . $item['otp_code'] . '<br />';
                    echo '----------------------------------------';
                    echo '<br />';
                }
            } else {
                echo 'No Confirmation Codes Found.';
            }

        } else {
            echo 'Error Code: ' . $api_response['code'] . '<br />';
            echo 'Error Message: ' . $api_response['msg'] . '<br />';
        }
        
    } else {
        echo 'Unknown Error';
    }

?>

Kartı bloke et

Bu API yöntemi, sanal kartı bloke ederek daha sonra kullanılmasını engellemenize olanak tanır.

Kart bakiyesinde fon varsa, bunlar iade tarifelerine uygun olarak kartın çıkarıldığı dahili hesaba iade edilir.

Ancak komisyon düşüldükten sonra iade tutarı minimum iade tutarından düşükse, bu fonlar kart bakiyesinden düşülür.

Aşağıdaki adrese POST isteği gönderin:
Parametre Tür Açıklama
card_id string Bloke etmek istediğiniz sanal kartın benzersiz tanımlayıcısı.

Yanıt parametreleri:

Parametre Tür Açıklama
status string İsteğin yürütülme durumu (örneğin, başarılı yürütülen istek için "success").
code string Yanıt kodu (örneğin, başarılı istek için "REQUEST_SUCCESS").
<?php 


    function cards_block($request_body = [])
    {
        $curl = curl_init('https://pay2.house/api/cards/block');
        curl_setopt($curl, CURLOPT_POST, TRUE);
        curl_setopt($curl, CURLOPT_POSTFIELDS, http_build_query($request_body));
        curl_setopt($curl, CURLOPT_RETURNTRANSFER, TRUE);
        curl_setopt($curl, CURLOPT_TIMEOUT, 30);
        curl_setopt($curl, CURLOPT_CUSTOMREQUEST, 'POST');
        curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, FALSE);
        curl_setopt($curl, CURLOPT_IPRESOLVE, CURL_IPRESOLVE_V4);
        
        $body = curl_exec($curl);
        $info = curl_getinfo($curl);

        curl_close($curl);

        if ( ! empty($info['http_code']) && $info['http_code'] === 200) {
            return json_decode($body, TRUE);
        }
    }


    $sign_token = create_token([
        'card_id' => 'VC7914059264'
    ]);

    
    $api_response = cards_block(['sign_token' => $sign_token, 'api_key' => 'YOUR_API_KEY']);
    if ( ! empty($api_response['status'])) {

        if ($api_response['status'] == 'success') {
            echo 'Card Blocked Successfully.';
        } else {
            echo 'Error Code: ' . $api_response['code'] . '<br />';
            echo 'Error Message: ' . $api_response['msg'] . '<br />';
        }
        
    } else {
        echo 'Unknown Error';
    }

?>

Kartı kapat

Bu API yöntemi, sanal kartı kapatarak daha sonra kullanılmasını engellemenize olanak tanır.

Kartta fon kalmışsa bu yöntemin kartı kapatmak için kullanılamayacağını belirtmek önemlidir.

Aşağıdaki adrese POST isteği gönderin:
Parametre Tür Açıklama
card_id string Kapatmak istediğiniz sanal kartın benzersiz tanımlayıcısı.

Yanıt parametreleri:

Parametre Tür Açıklama
status string İsteğin yürütülme durumu (örneğin, başarılı yürütülen istek için "success").
code string Yanıt kodu (örneğin, başarılı istek için "REQUEST_SUCCESS").
<?php 


    function card_close($request_body = [])
    {
        $curl = curl_init('https://pay2.house/api/cards/close');
        curl_setopt($curl, CURLOPT_POST, TRUE);
        curl_setopt($curl, CURLOPT_POSTFIELDS, http_build_query($request_body));
        curl_setopt($curl, CURLOPT_RETURNTRANSFER, TRUE);
        curl_setopt($curl, CURLOPT_TIMEOUT, 30);
        curl_setopt($curl, CURLOPT_CUSTOMREQUEST, 'POST');
        curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, FALSE);
        curl_setopt($curl, CURLOPT_IPRESOLVE, CURL_IPRESOLVE_V4);
        
        $body = curl_exec($curl);
        $info = curl_getinfo($curl);

        curl_close($curl);

        if ( ! empty($info['http_code']) && $info['http_code'] === 200) {
            return json_decode($body, TRUE);
        }
    }


    $sign_token = create_token([
        'card_id' => 'VC7914059264'
    ]);

    
    $api_response = card_close(['sign_token' => $sign_token, 'api_key' => 'YOUR_API_KEY']);
    if ( ! empty($api_response['status'])) {

        if ($api_response['status'] == 'success') {
            echo 'Card Closed Successfully.';
        } else {
            echo 'Error Code: ' . $api_response['code'] . '<br />';
            echo 'Error Message: ' . $api_response['msg'] . '<br />';
        }
        
    } else {
        echo 'Unknown Error';
    }

?>

Kart bloke durumları

Olası kart bloke durumlarının ve anlamlarının açıklaması.

Durum Açıklama
terms_violation Kullanım şartlarının ihlali
insufficient_funds Yetersiz fon
unauthorized_topup Yetkisiz bakiye yükleme girişimleri
high_refund_rate Yüksek iade oranı
prebilling İlk faturalandırma
subscription_delay Abonelik ücreti gecikmesi
invalid_personal_data Yanlış veya eksik kişisel veriler
illegal_activity Yasa dışı eylem girişimleri
verification_issues Doğrulama sorunları
high_risk Yüksek risk seviyesi
terms_change Kart şartlarının değişmesi
inactivity Hareketsizlik
internal_errors Dahili hatalar
regulatory_requirements Düzenleyici gereksinimler
user_blocked Müşteri kartı bloke etti
not_blocked Bloke edilmemiş

Webhook Events

Ödeme durumu "Ödendi" olarak değişir değişmez, Pay2.House merchant için ayarladığınız önceden belirtilmiş Webhook URL adresinize webhook formatında otomatik bildirimler gönderir.

HTTP status 200 ve "OK" yanıt metnini alana kadar bildirimi 100 kez göndereceğiz.

Ayrıca sistemimiz, istek başlığına benzersiz token içeren "Pay2-House-Signature" parametresini otomatik olarak ekler. Bu tokeni isteğin gerçekliğini doğrulamak için kullanabilirsiniz.

<?php 

    // Function for decoding webhook data
    function decrypt_webhook($data = NULL, $secret_key = NULL) 
    {
        $decoded_data = base64_decode($data);

        if ($decoded_data === FALSE) {
            return FALSE;
        }

        list($iv, $signature, $encrypted_data) = explode('|', $decoded_data);
        $calculated_signature = hash_hmac('sha256', $iv . '|' . $encrypted_data, $secret_key);

        if (hash_equals($calculated_signature, $signature)) {
            $decoded_encrypted_data = openssl_decrypt(
                base64_decode($encrypted_data), 
                'AES-256-CBC', 
                hex2bin(hash('sha256', $secret_key)), 
                0, 
                hex2bin(bin2hex(hex2bin($iv)))
            );
            if ($decoded_encrypted_data !== FALSE) {
                return $decoded_encrypted_data;
            }
        }

        return FALSE;
    }

    
    // Retrieving the webhook request body and decoding the JSON
    $payload_body   = file_get_contents('php://input');
    $payload_decode = json_decode($payload_body, TRUE);


    // Checking for the presence of a signature in the request header
    if ( ! empty($_SERVER['HTTP_PAY2_HOUSE_SIGNATURE'])) {
        // Decoding webhook data and outputting the decoded data
        $decrypt_webhook = decrypt_webhook($_SERVER['HTTP_PAY2_HOUSE_SIGNATURE'], 'YOUR_API_KEY');
        if ($decrypt_webhook !== FALSE) {
            $webhook_decode = json_decode($decrypt_webhook, TRUE);
        }
    }


    // Example print of $payload_decode and $webhook_decode
    // Array
    // (
    //     [invoice_number] => IN4063112032
    //     [external_number] => test
    //     [amount] => 10
    //     [handling_fee] => 0
    //     [currency_code] => EUR
    //     [description] => Test Payment for Pay2.House
    //     [status] => paid
    // )


    // Setting HTTP status 200 and terminating the script with the response text "OK"
    http_response_code(200);
    exit('OK');
?>

Olası hatalar

API kullanılırken ortaya çıkabilecek olası hatalardan bazıları aşağıdadır.

Hata kodu Hata açıklaması
INVALID_TOKEN Geçersiz veya eksik imza tokeni.
INVALID_API_KEY Geçersiz veya eksik API anahtarı.
API_KEY_NOT_FOUND Belirtilen API anahtarı bulunamadı.
INACTIVE_API_KEY Sağlanan API anahtarı aktif değil.
SIGNATURE_DECODING_FAILED İmza çözümlenirken hata oluştu.
INVALID_SIGNATURE_DATA Geçersiz imza verileri.
EXPIRED_SIGNATURE İmzanın süresi doldu.
MISMATCHED_SIGNATURE_ISSUER Geçersiz veya eksik Key ID.
INVALID_MERCHANT_ID Geçersiz veya eksik Merchant ID.
MERCHANT_ID_NOT_FOUND Merchant ID bulunamadı.
ACCESS_DENIED_MERCHANT Belirtilen Merchant ID erişimi reddedildi.
INVALID_EXTERNAL_NUMBER Geçersiz veya eksik harici ödeme numarası.
INVALID_AMOUNT Geçersiz tutar.
INVALID_CURRENCY_CODE Geçersiz para birimi kodu.
INVALID_DESCRIPTION Geçersiz veya eksik ödeme açıklaması.
SIGNATURE_VERIFICATION_FAILED İmza doğrulaması bir hata nedeniyle başarısız oldu.
INVALID_RETURN_URL Başarılı ödeme sonrası dönüş URL adresi geçersiz veya eksik.
INVALID_CANCEL_URL Ödeme iptali URL adresi geçersiz veya eksik.
INVALID_PAYER_EMAIL Geçersiz müşteri e-posta adresi.
INVALID_COMMENT Geçersiz veya eksik yorum.
INSUFFICIENT_SENDER_BALANCE Gönderen hesabında yetersiz bakiye.
AMOUNT_EXCEEDS_SENDER_BALANCE Transfer tutarı gönderen hesabındaki kullanılabilir bakiyeyi aşıyor.
SENDER_ACCOUNT_NOT_FOUND Gönderen hesabı bulunamadı.
INVALID_SENDER_ACCOUNT Geçersiz gönderen hesabı.
RECIPIENT_ACCOUNT_NOT_FOUND Alıcı hesabı bulunamadı.
INVALID_RECIPIENT_ACCOUNT Geçersiz alıcı hesabı.
DIFFERENT_CURRENCY_CODES Gönderen ve alıcı hesaplarının para birimleri farklı.
INVALID_TRANSFER Gönderen ve alıcı hesapları aynı olamaz.
PROVIDER_NOT_FOUND Ödeme yöntemi bulunamadı veya aktif değil.
PROVIDER_OPTION_NOT_FOUND Ödeme yöntemi seçenekleri bulunamadı.
AMOUNT_BELOW_MINIMUM Transfer tutarı minimum eşiğin altında.
AMOUNT_EXCEEDS_MAXIMUM Transfer tutarı maksimum limiti aşıyor.
INSUFFICIENT_BALANCE_AFTER_FEE Komisyon dikkate alındıktan sonra gönderen hesabında yetersiz bakiye.
INVALID_NAME_WALLET Geçersiz veya eksik hesap adı.
INVALID_PAYMENT_METHOD Geçersiz ödeme yöntemi.
PAY2_HOUSE_NOT_ENABLED Pay2.House ödeme yöntemi merchantınız için kullanılamıyor.
USDT_TRC20_NOT_ENABLED Tether USDT ödeme yöntemi merchantınız için kullanılamıyor.
CARDS_NOT_ENABLED CARDS ödeme yöntemi merchantınız için kullanılamıyor.
TRON_ACCOUNT_CREATION_ERROR TRON hesabı oluşturma hatası.
INVALID_INVOICE_NUMBER Geçersiz hesap numarası formatı.
INVOICE_NOT_FOUND Hesap bulunamadı.
MAX_WALLETS_REACHED Hesabınız için izin verilen maksimum hesap sayısına ulaşıldı.
MERCHANT_NOT_APPROVED Merchant ödeme işleme için onaylanmamış.
INVALID_DEADLINE_SECONDS Ödemenin süresinin dolmasına kadar olan zaman aralığı değeri geçersiz.
USER_DELETED Kullanıcı silindi.
USER_BANNED Kullanıcı bloke edildi.
USER_TEMPORARILY_BLOCKED Kullanıcı geçici olarak bloke edildi.
USER_NOT_FOUND Kullanıcı bulunamadı.
INVALID_PER_PAGE "per_page" parametresi için geçersiz değer. Değer 10 ile 100 arasında olmalıdır.
INVALID_PAGE "page" parametresi için geçersiz değer. Değer pozitif bir tam sayı olmalıdır.
INVALID_STATUS Geçersiz durum.
INSUFFICIENT_BALANCE Bu işlemi gerçekleştirmek için hesapta yeterli fon yok.
INVALID_FIRST_NAME Ad yanlış belirtilmiş.
INVALID_LAST_NAME Soyadı yanlış belirtilmiş.
INVALID_SUR_NAME İkinci ad yanlış belirtilmiş.
INVALID_ADDRESS İkamet adresi yanlış belirtilmiş.
INVALID_CITY İkamet şehri yanlış belirtilmiş.
INVALID_REGION İkamet bölgesi yanlış belirtilmiş.
INVALID_POST_CODE Posta kodu yanlış belirtilmiş.
INVALID_EMAIL E-posta yanlış belirtilmiş.
INVALID_DATE_BIRTH Doğum tarihi yanlış belirtilmiş.
FORBIDDEN_COUNTRY Ülkenin kullanımı izinli değil.
INVALID_PHONE_NUMBER Telefon numarası yanlış belirtilmiş.
INVALID_COUNTRY_CODE Ülke kodu yanlış belirtilmiş.
VERIFICATION_REQUIRED İşlemi gerçekleştirmek için hesap doğrulaması gereklidir.
CARD_ISSUANCE_FAILED Kart çıkarılamadı.
INVALID_BIN_NUMBER Geçersiz veya eksik BIN numarası.
ACCOUNT_NOT_FOUND Belirtilen hesap bulunamadı.
INVALID_ACCOUNT_NUMBER Geçersiz veya eksik hesap numarası.
CARD_NOT_FOUND Kart bulunamadı.
CARD_BLOCKED Kart bloke edildi.
CARD_CLOSED Kart kapalı.
CARD_AWAITING Kart çıkarılma sürecinde.
CARD_REFUND_FAILED Karttan para iadesi başarısız oldu.
CARD_BLOCKING_FAILED Kart blokesi dahili sistem hatası nedeniyle başarısız oldu.
CARD_DETAILS_FAILED Kart detayları alınamadı.
CARD_BALANCE_NOT_ZERO Kartta fon kaldığı için kart kapatılamaz.
CARD_CLOSING_FAILED Kart kapatma dahili sistem hatası nedeniyle başarısız oldu.
REFUND_NOT_ALLOWED Para iadesine izin verilmiyor.
CARD_HAS_NO_BALANCE Kartta bakiye yok.
CARD_REFUND_MIN_AMOUNT Minimum iade tutarına ulaşılmadı.
CARD_REFUND_MAX_AMOUNT İade tutarı maksimum limiti aşıyor.
CARD_REFUND_COST_GREATER Komisyon düşüldükten sonra iade tutarı izin verilen minimum iade tutarından düşük.
CARD_REFUND_AMOUNT_ZERO İade tutarı sıfırdan büyük olmalıdır.
ACCOUNT_DELETED Belirtilen hesap silindi.
CARD_MINIMUM_AMOUNT Bakiye yükleme tutarı minimum tutarın üzerinde olmalıdır.
CARD_MAXIMUM_AMOUNT Bakiye yükleme tutarı izin verilen maksimum tutarı aşıyor.
CARD_BALANCE_REFRESH_FAILED Kart bakiyesi güncellenemedi.
CARD_HISTORY_REFRESH_FAILED Kart işlem geçmişi güncellenemedi.
SENDER_ACCOUNT_DELETED Gönderen hesabı silindiği veya devre dışı bırakıldığı için fon transferi mümkün değil.
RECIPIENT_ACCOUNT_DELETED Alıcı hesabı silindiği veya devre dışı bırakıldığı için fon transferi mümkün değil.
TRANSACTION_NOT_PROCESSED İşlem hata veya dahili kısıtlamalar nedeniyle işlenmedi.
TRANSACTION_NOT_FOUND İşlem sistemde bulunamadı.
INVALID_TRANSACTION_NUMBER Geçersiz veya eksik işlem numarası.
INVALID_DATE_RANGE Yanlış tarih aralığı belirtilmiş. Formatı ve mantıksal doğruluğu kontrol edin (başlangıç tarihi bitiş tarihinden büyük olamaz).
Sitemizin işleyişini iyileştirmek için çerezler kullanıyoruz. Siteyi kullanmaya devam ederek Gizlilik Politikamızı ve Kullanım Koşullarımızı kabul etmiş olursunuz.