मैनेजर से संपर्क करें
शुरुआत कहाँ से करें?
Pay2.House लॉग इन करें

API

Pay2.House

API कुंजी बनाएँ

API कुंजी बनाने के लिए, लिंक पर जाएँ: https://pay2.house/keys/prepare

अनुरोधों का प्राधिकरण

Pay2.House API अनुरोधों को अधिकृत करने के लिए JSON Web Tokens (JWT) का उपयोग करता है।

JSON Web Tokens (JWT) के बारे में अधिक जानकारी के लिए, JWT टोकन गाइड पढ़ने की अनुशंसा की जाती है।

API के साथ काम करने के लिए आपको एक ऐसी लाइब्रेरी इंस्टॉल करनी होगी जो JSON Web Tokens (JWT) जनरेट और प्रोसेस कर सके। निम्न लाइब्रेरी का उपयोग करने की अनुशंसा की जाती है: 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');
    }

?>

भुगतान बनाएँ

यह API विधि Pay2.House भुगतान सेवा के माध्यम से भुगतान करने के लिए एक नया भुगतान प्रारंभ करने की अनुमति देती है।

निम्न पते पर POST अनुरोध भेजें:
पैरामीटर प्रकार विवरण
external_number string अद्वितीय ट्रांज़ैक्शन या ऑर्डर नंबर।
amount number भुगतान या ट्रांज़ैक्शन की राशि।
currency_code string भुगतान की मुद्रा कोड (उदाहरण के लिए, USD डॉलर के लिए, EUR यूरो के लिए, USDT Tether के लिए)।
merchant_id string आपके जोड़े गए मर्चेंट का पहचानकर्ता (Merchant ID)।
description string भुगतान या ट्रांज़ैक्शन का विवरण।
deadline_seconds number भुगतान करने के लिए समय अंतराल सेकंड में सेट करता है (उदाहरण के लिए, 600 का अर्थ 10 मिनट की भुगतान अवधि है)। अधिकतम मान 86400 सेकंड (1 दिन) है।
return_url string वह URL पता जहाँ ग्राहक को भुगतान सफलतापूर्वक पूरा होने के बाद वापस भेजना चाहिए।
cancel_url string वह URL पता जहाँ भुगतान रद्द होने की स्थिति में ग्राहक को वापस भेजना चाहिए।
handling_fee number अतिरिक्त भुगतान शुल्क।
payer_email string भुगतान ट्रांज़ैक्शन से संबंधित ग्राहक का ईमेल।
payment_method string इस ट्रांज़ैक्शन के लिए उपयोग की जाने वाली भुगतान विधि। उपलब्ध विधियाँ: «PAY2_HOUSE», «USDT_TRC20», «CARDS». डिफ़ॉल्ट रूप से «ALL», जिसका अर्थ है कि ग्राहक भुगतान विधि स्वयं चुन सकता है।

Response parameters:

पैरामीटर प्रकार विवरण
status string अनुरोध निष्पादन की स्थिति (उदाहरण के लिए, सफल अनुरोध के लिए "success")।
code string Response code (उदाहरण के लिए, सफल अनुरोध के लिए "REQUEST_SUCCESS")।
invoice_number string अद्वितीय invoice नंबर, जो सिस्टम में भुगतान ट्रांज़ैक्शन की पहचान करता है।
approval_url string URL लिंक जहाँ ग्राहक को भुगतान पूरा करने के लिए redirect करना होगा।
<?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);
    }

?>

भुगतान जानकारी

यह API विधि Pay2.House भुगतान सिस्टम में आपके भुगतान की जानकारी माँगने की अनुमति देती है।

निम्न पते पर POST अनुरोध भेजें:
पैरामीटर प्रकार विवरण
merchant_id string आपके जोड़े गए मर्चेंट का पहचानकर्ता (Merchant ID)।
invoice_number string आपका invoice नंबर।

Response parameters:

पैरामीटर प्रकार विवरण
status string अनुरोध निष्पादन की स्थिति (उदाहरण के लिए, सफल अनुरोध के लिए "success")।
code string Response code (उदाहरण के लिए, सफल अनुरोध के लिए "REQUEST_SUCCESS")।
invoice_number string अद्वितीय invoice नंबर, जो सिस्टम में भुगतान ट्रांज़ैक्शन की पहचान करता है।
currency_code string भुगतान की मुद्रा कोड (उदाहरण के लिए, USD डॉलर के लिए, EUR यूरो के लिए, USDT Tether के लिए)।
currency_symbol string मुद्रा प्रतीक (उदाहरण के लिए, अमेरिकी डॉलर के लिए "$")।
external_number string भुगतान ट्रांज़ैक्शन से जुड़ा बाहरी नंबर।
description string भुगतान ट्रांज़ैक्शन या invoice का विवरण।
amount number निर्दिष्ट मुद्रा में भुगतान राशि।
handling_fee number भुगतान प्रोसेसिंग शुल्क की राशि।
payment_status string

भुगतान स्थिति।

भुगतान की प्रतीक्षा में: pending

प्रोसेसिंग में: in_processing

भुगतान किया गया: paid

रद्द किया गया: cancelled

समय समाप्त: overdue

आंशिक रूप से भुगतान किया गया: partially

भुगतान त्रुटि: error

धनवापसी: 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';
    }

?>

ट्रांसफर बनाएँ

यह API विधि Pay2.House सिस्टम में आंतरिक खाते में एक नया ट्रांसफर प्रारंभ करने की अनुमति देती है।

निम्न पते पर POST अनुरोध भेजें:
पैरामीटर प्रकार विवरण
sender_account string भेजने वाले का खाता।
recipient_account string प्राप्तकर्ता का खाता।
amount number ट्रांसफर राशि।
comment string ट्रांसफर टिप्पणी।

Response parameters:

पैरामीटर प्रकार विवरण
status string अनुरोध निष्पादन की स्थिति (उदाहरण के लिए, सफल अनुरोध के लिए "success")।
code string Response code (उदाहरण के लिए, सफल अनुरोध के लिए "REQUEST_SUCCESS")।
transaction_number string अद्वितीय ट्रांसफर नंबर।
<?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';
    }

?>

ट्रांसफर जानकारी

यह API विधि ट्रांसफर की विस्तृत जानकारी प्राप्त करने की अनुमति देती है, जिसमें स्थिति, राशि, निष्पादन की तारीख और समय, साथ ही अन्य संबंधित डेटा शामिल हैं।

निम्न पते पर POST अनुरोध भेजें:
पैरामीटर प्रकार विवरण
transaction_number string अद्वितीय ट्रांज़ैक्शन नंबर, जिसका उपयोग किसी विशिष्ट ट्रांसफर की पहचान के लिए किया जाता है।

Response parameters:

पैरामीटर प्रकार विवरण
status string अनुरोध निष्पादन की स्थिति (उदाहरण के लिए, सफल अनुरोध के लिए "success")।
code string Response code (उदाहरण के लिए, सफल अनुरोध के लिए "REQUEST_SUCCESS")।
transaction_number string अद्वितीय ट्रांज़ैक्शन नंबर।
time_created number Unix timestamp फ़ॉर्मेट में ट्रांज़ैक्शन निर्माण समय।
date_created string YYYY-MM-DD फ़ॉर्मेट में ट्रांज़ैक्शन निर्माण तारीख।
sender_account string धन भेजने वाले खाते का नंबर।
recipient_account string धन प्राप्त करने वाले खाते का नंबर।
amount number ट्रांज़ैक्शन में ट्रांसफर की गई राशि।
fee_amount number ट्रांज़ैक्शन के लिए लिया गया शुल्क।
currency_code string ट्रांज़ैक्शन मुद्रा कोड (उदाहरण के लिए, USD डॉलर के लिए, EUR यूरो के लिए, USDT Tether के लिए)।
payment_method string

इस ट्रांज़ैक्शन के लिए उपयोग की गई भुगतान विधि।

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

ट्रांज़ैक्शन पुष्टि विधि।

SMS द्वारा पुष्टि: verification_phone

Google Authenticator: verification_code

API के माध्यम से पुष्टि: verification_api

बिना पुष्टि: none
payment_type string

भुगतान प्रकार।

आंतरिक ट्रांसफर: transfer

खाता टॉप-अप: refill

मुद्रा विनिमय: exchange

Invoice जारी करना: invoice

Merchant API: merchant
transaction_type string ट्रांज़ैक्शन प्रकार (incoming - जमा, withdrawal - निकासी)।
transaction_status string

ट्रांज़ैक्शन स्थिति।

प्रोसेसिंग में: in_processing

पुष्टि की गई: confirmed

त्रुटि: error
comment string ट्रांज़ैक्शन के बारे में अतिरिक्त जानकारी।
error_message string यदि ट्रांज़ैक्शन विफल हुआ हो तो त्रुटि संदेश।
<?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';
    }

?>

ट्रांसफर इतिहास

यह API विधि ट्रांज़ैक्शन सूची माँगने की अनुमति देती है, जिसमें सभी किए गए ट्रांसफरों की जानकारी दी जाती है।

निम्न पते पर POST अनुरोध भेजें:
पैरामीटर प्रकार विवरण
per_page number एक पृष्ठ पर प्रदर्शित होने वाले रिकॉर्ड की संख्या।
page number Pagination के लिए पृष्ठ नंबर।
transaction_type string ट्रांज़ैक्शन प्रकार के अनुसार फ़िल्टर (incoming - जमा, withdrawal - निकासी)।
status string

ट्रांज़ैक्शन स्थिति के अनुसार फ़िल्टर।

प्रोसेसिंग में: in_processing

पुष्टि की गई: confirmed

त्रुटि: error
date_range string तारीख सीमा के अनुसार चयन के लिए फ़िल्टर (DD.MM.YYYY - DD.MM.YYYY फ़ॉर्मेट में), फ़िल्टरिंग के लिए भी उपयोग किया जाता है।

Response parameters:

पैरामीटर प्रकार विवरण
status string अनुरोध निष्पादन की स्थिति (उदाहरण के लिए, सफल अनुरोध के लिए "success")।
code string Response code (उदाहरण के लिए, सफल अनुरोध के लिए "REQUEST_SUCCESS")।
count number अनुरोध से मेल खाने वाले ट्रांज़ैक्शनों की कुल संख्या।
transactions array

ट्रांज़ैक्शन objects का array, जिसमें प्रत्येक ट्रांज़ैक्शन की जानकारी होती है (जैसे identifier, status, balance आदि)।

ट्रांसफर जानकारी अनुभाग में सभी फ़ील्ड का विवरण देखें।
<?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';
    }

?>

खातों की सूची प्राप्त करें

यह API विधि Pay2.House सिस्टम में आपके अकाउंट से जुड़े सभी खातों की सूची माँगने की अनुमति देती है।

निम्न पते पर POST अनुरोध भेजें:
पैरामीटर प्रकार विवरण
delete_flag number खाता हटाने का flag। मान 0 सक्रिय खाते को दर्शाता है, और मान 1 हटाए गए या ब्लॉक किए गए खाते को दर्शाता है।
currency_code string खातों को फ़िल्टर करने के लिए मुद्रा कोड (उदाहरण के लिए, डॉलर के लिए "USD", यूरो के लिए "EUR", Tether के लिए "USDT")।

Response parameters:

पैरामीटर प्रकार विवरण
status string अनुरोध निष्पादन की स्थिति (उदाहरण के लिए, सफल अनुरोध के लिए "success")।
code string Response code (उदाहरण के लिए, सफल अनुरोध के लिए "REQUEST_SUCCESS")।
count number अनुरोध से मेल खाने वाले खातों की कुल संख्या।
wallets array

खाता objects का array, जिसमें प्रत्येक खाते की जानकारी होती है (जैसे identifier, status, balance आदि)।

खाता जानकारी अनुभाग में सभी फ़ील्ड का विवरण देखें।
<?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';
    }

?>

खाता बनाएँ

यह API विधि अद्वितीय खाते बनाने की अनुमति देती है, जिन्हें Pay2.House सिस्टम के भीतर भुगतान और ट्रांज़ैक्शन के लिए उपयोग किया जा सकता है।

निम्न पते पर POST अनुरोध भेजें:
पैरामीटर प्रकार विवरण
name string खाते का नाम।
currency_code string भुगतान की मुद्रा कोड (उदाहरण के लिए, USD डॉलर के लिए, EUR यूरो के लिए, USDT Tether के लिए)।

Response parameters:

पैरामीटर प्रकार विवरण
status string अनुरोध निष्पादन की स्थिति (उदाहरण के लिए, सफल अनुरोध के लिए "success")।
code string Response code (उदाहरण के लिए, सफल अनुरोध के लिए "REQUEST_SUCCESS")।
account_number string बनाए गए खाते का नंबर।
<?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';
    }

?>

खाता जानकारी

यह API विधि Pay2.House भुगतान सिस्टम में आपके खाते की जानकारी माँगने की अनुमति देती है।

निम्न पते पर POST अनुरोध भेजें:
पैरामीटर प्रकार विवरण
account_number string आपका खाता नंबर।

Response parameters:

पैरामीटर प्रकार विवरण
status string अनुरोध निष्पादन की स्थिति (उदाहरण के लिए, सफल अनुरोध के लिए "success")।
code string Response code (उदाहरण के लिए, सफल अनुरोध के लिए "REQUEST_SUCCESS")।
time_created number Unix timestamp फ़ॉर्मेट में खाता निर्माण समय।
date_created string YYYY-MM-DD फ़ॉर्मेट में खाता निर्माण तारीख।
delete_flag number हटाने का flag (0 — हटाया नहीं गया, 1 — हटाया गया)।
account_number string खाता नंबर।
currency_code string खाते की मुद्रा कोड (उदाहरण के लिए, USD डॉलर के लिए, EUR यूरो के लिए, USDT Tether के लिए)।
currency_symbol string मुद्रा प्रतीक (उदाहरण के लिए, अमेरिकी डॉलर के लिए "$")।
name string खाते का नाम।
balance number खाते में वर्तमान बैलेंस।
bonus number खाते में उपलब्ध bonus funds की राशि, यदि लागू हो।
trc20_address string Tokens के लिए TRC-20 address, यदि लागू हो।
<?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';
    }

?>

खाता स्टेटमेंट प्राप्त करें

यह API विधि चयनित खाते का विस्तृत statement प्राप्त करने की अनुमति देती है, जिसमें सभी ट्रांज़ैक्शन और बैलेंस बदलावों की जानकारी शामिल होती है।

निम्न पते पर POST अनुरोध भेजें:
पैरामीटर प्रकार विवरण
account_number string आपका खाता नंबर।

Response parameters:

पैरामीटर प्रकार विवरण
status string अनुरोध निष्पादन की स्थिति (उदाहरण के लिए, सफल अनुरोध के लिए "success")।
code string Response code (उदाहरण के लिए, सफल अनुरोध के लिए "REQUEST_SUCCESS")।
download_url string CSV फ़ॉर्मेट में खाता statement फ़ाइल डाउनलोड करने के लिए 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 सूची प्राप्त करें

यह API विधि Pay2.House सिस्टम में virtual cards जारी करने के लिए उपलब्ध BIN की सूची प्राप्त करने की अनुमति देती है।

निम्न पते पर POST अनुरोध भेजें:
पैरामीटर प्रकार विवरण
currency_code string BIN मुद्रा कोड (उदाहरण के लिए USD, EUR)।
country_code string ISO 3166-1 alpha-2 फ़ॉर्मेट में BIN country code (उदाहरण के लिए US, HK)।
card_type string

कार्ड प्रकार।

Virtual: virtual

Physical: physical
card_network string

Payment system।

Visa: visa

MasterCard: mastercard
card_product_type string

Card product type।

Personal: personal

Standard: standard

Response parameters:

पैरामीटर प्रकार विवरण
status string अनुरोध निष्पादन की स्थिति (उदाहरण के लिए, सफल अनुरोध के लिए "success")।
code string Response code (उदाहरण के लिए, सफल अनुरोध के लिए "REQUEST_SUCCESS")।
count number अनुरोध से मेल खाने वाले BIN की कुल संख्या।
bins array BIN objects का array, जिसमें प्रत्येक BIN की जानकारी होती है।
bin string Bank Identification Number।
currency_code string BIN मुद्रा कोड (उदाहरण के लिए USD, EUR)।
country_code string ISO 3166-1 alpha-2 फ़ॉर्मेट में BIN country code (उदाहरण के लिए US, HK)।
card_type string Payment system (उदाहरण के लिए visa, mastercard)।
card_product_type string Card product type (उदाहरण के लिए standard, personal)।
card_tier string Card level (उदाहरण के लिए premium, shared)।
verification_required number क्या verification आवश्यक है (1 — हाँ, 0 — नहीं)।
<?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';
    }

?>

कार्डों की सूची प्राप्त करें

यह API विधि Pay2.House सिस्टम में आपके अकाउंट पर जारी virtual cards की सूची माँगने की अनुमति देती है।

निम्न पते पर POST अनुरोध भेजें:
पैरामीटर प्रकार विवरण
per_page number एक पृष्ठ पर प्रदर्शित होने वाले रिकॉर्ड की संख्या।
page number Pagination के लिए पृष्ठ नंबर।
status string

कार्ड स्थिति के अनुसार फ़िल्टर।

सक्रिय: active

ब्लॉक किया गया: blocked

बंद: closed

जारी होने की प्रतीक्षा में: awaiting

Response parameters:

पैरामीटर प्रकार विवरण
status string अनुरोध निष्पादन की स्थिति (उदाहरण के लिए, सफल अनुरोध के लिए "success")।
code string Response code (उदाहरण के लिए, सफल अनुरोध के लिए "REQUEST_SUCCESS")।
count number अनुरोध से मेल खाने वाले कार्डों की कुल संख्या।
cards array

कार्ड objects का array, जिसमें प्रत्येक कार्ड की जानकारी होती है (जैसे identifier, status, balance आदि)।

कार्ड जानकारी अनुभाग में सभी फ़ील्ड का विवरण देखें।
<?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';
    }

?>

कार्ड जारी करें

यह API विधि Pay2.House सिस्टम में नया virtual card जारी करने की अनुमति देती है।

निम्न पते पर POST अनुरोध भेजें:
पैरामीटर प्रकार विवरण
account_number string आपका खाता नंबर, जिससे कार्ड जारी करने का शुल्क काटा जाएगा।
first_name string कार्डधारक का पहला नाम।
last_name string कार्डधारक का उपनाम।
sur_name string कार्डधारक का मध्य नाम।
date_birth string DD.MM.YYYY फ़ॉर्मेट में कार्डधारक की जन्मतिथि।
phone_number string देश कोड सहित कार्डधारक का फोन नंबर।
address string कार्डधारक का आवासीय पता।
city string कार्डधारक का निवास शहर।
region string कार्डधारक के निवास का क्षेत्र या प्रदेश।
post_code string आवासीय पते का postal code।
email string कार्डधारक का ईमेल।
country_code string ISO 3166-1 alpha-2 मानक के अनुसार देश कोड (उदाहरण के लिए, United States के लिए "US")।
bin_number string कार्ड का Bank Identification Number (BIN)। इसे तकनीकी सहायता में tickets के माध्यम से अनुरोध करना आवश्यक है।
renewal_payment_flag number यह flag बताता है कि कार्ड पर पर्याप्त funds न होने पर कार्ड renewal के लिए funds Pay2.House मुख्य खाते से काटे जा सकते हैं या नहीं (1 - हाँ, 0 - नहीं)।

Response parameters:

पैरामीटर प्रकार विवरण
status string अनुरोध निष्पादन की स्थिति (उदाहरण के लिए, सफल अनुरोध के लिए "success")।
code string Response code (उदाहरण के लिए, सफल अनुरोध के लिए "REQUEST_SUCCESS")।
card_number string जारी किए गए कार्ड का नंबर।
card_id string सिस्टम में कार्ड का अद्वितीय identifier, जिसका उपयोग आगे की operations के लिए किया जाता है।
<?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';
    }

?>

कार्ड जानकारी

यह API विधि virtual card की विस्तृत जानकारी प्राप्त करने की अनुमति देती है, जिसमें कार्ड नंबर, status, issue date और अन्य संबंधित डेटा शामिल है।

निम्न पते पर POST अनुरोध भेजें:
पैरामीटर प्रकार विवरण
card_id string सिस्टम में कार्ड का अद्वितीय identifier, जिसका उपयोग उसके details प्राप्त करने के लिए किया जाता है।

Response parameters:

पैरामीटर प्रकार विवरण
status string अनुरोध निष्पादन की स्थिति (उदाहरण के लिए, सफल अनुरोध के लिए "success")।
code string Response code (उदाहरण के लिए, सफल अनुरोध के लिए "REQUEST_SUCCESS")।
card_name string कार्ड जारी करते समय दिया गया कार्ड नाम।
card_number string जारी किए गए कार्ड का नंबर।
card_id string सिस्टम में कार्ड का अद्वितीय identifier।
cvv string Authorization के लिए आवश्यक कार्ड security code।
expiration_date string MM/YY फ़ॉर्मेट में कार्ड expiry date।
password string Online transactions में अतिरिक्त सुरक्षा के लिए 3DS password।
currency_code string कार्ड operations के लिए उपयोग की जाने वाली मुद्रा कोड।
currency_symbol string मुद्रा प्रतीक (उदाहरण: $ या €)।
time_created number Unix timestamp फ़ॉर्मेट में कार्ड निर्माण समय।
date_created string YYYY-MM-DD फ़ॉर्मेट में कार्ड निर्माण तारीख।
date_renewal string YYYY-MM-DD फ़ॉर्मेट में कार्ड renewal के लिए अगली deduction date।
time_renewal number Unix timestamp फ़ॉर्मेट में कार्ड renewal के लिए अगली deduction time।
email string कार्ड जारी करते समय दिया गया ईमेल पता।
phone_number string कार्ड जारी करते समय दिया गया फोन नंबर।
address_line_1 string कार्ड जारी करते समय दिया गया आवासीय पता।
city string कार्ड जारी करते समय दिया गया निवास शहर।
country_code string ISO 3166-1 alpha-2 मानक के अनुसार देश कोड (उदाहरण के लिए, United States के लिए "US")।
first_name string कार्ड मालिक का पहला नाम।
last_name string कार्ड मालिक का उपनाम।
sur_name string कार्ड मालिक का मध्य नाम।
date_birth string DD.MM.YYYY फ़ॉर्मेट में कार्ड मालिक की जन्मतिथि।
post_code string Postal code।
card_status string

कार्ड स्थिति।

सक्रिय: active

ब्लॉक किया गया: blocked

बंद: closed

जारी होने की प्रतीक्षा में: awaiting
balance number कार्ड का वर्तमान बैलेंस।
issuance_cost number कार्ड जारी करने की लागत।
renewal_cost number कार्ड renewal की लागत।
recharge_cost number कार्ड टॉप-अप शुल्क।
recharge_type string कार्ड टॉप-अप शुल्क का प्रकार ("fixed" fixed fee के लिए या "percent" percentage fee के लिए हो सकता है)। शुल्क का मान recharge_cost पैरामीटर से लिया जाता है।
account_refund_cost number कार्ड से धनवापसी शुल्क।
account_refund_type string कार्ड से धनवापसी शुल्क का प्रकार ("fixed" fixed fee के लिए या "percent" percentage fee के लिए हो सकता है)। शुल्क का मान account_refund_cost पैरामीटर से लिया जाता है।
refund_min_amount number कार्ड से धनवापसी की न्यूनतम राशि।
min_recharge_amount number कार्ड टॉप-अप की न्यूनतम राशि।
max_recharge_amount number कार्ड टॉप-अप की अधिकतम राशि।
block_status string

कार्ड ब्लॉकिंग स्थिति।

संभावित मान कार्ड ब्लॉकिंग स्थितियाँ अनुभाग में मिल सकते हैं।
date_blocked string YYYY-MM-DD फ़ॉर्मेट में कार्ड ब्लॉकिंग तारीख।
time_blocked number Unix timestamp फ़ॉर्मेट में कार्ड ब्लॉकिंग समय।
<?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';
    }

?>

कार्ड का नाम बदलें

यह API विधि Pay2.House सिस्टम में वर्चुअल कार्ड का नाम बदलने की अनुमति देती है।

निम्न पते पर POST अनुरोध भेजें:
पैरामीटर प्रकार विवरण
card_id string सिस्टम में कार्ड का अद्वितीय identifier, जिसका उपयोग उसके details प्राप्त करने के लिए किया जाता है।
name string वर्चुअल कार्ड का नया नाम। अधिकतम लंबाई — 100 अक्षर।

Response parameters:

पैरामीटर प्रकार विवरण
status string अनुरोध निष्पादन की स्थिति (उदाहरण के लिए, सफल अनुरोध के लिए "success")।
code string Response code (उदाहरण के लिए, सफल अनुरोध के लिए "REQUEST_SUCCESS")।
card_name string बदलाव के बाद वर्चुअल कार्ड का नाम।
<?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';
    }

?>

कार्ड टॉप-अप

यह API विधि आपके आंतरिक खाते का उपयोग करके virtual card balance top up करने की अनुमति देती है।

टॉप-अप अनुरोध बनाने के 2-3 मिनट के भीतर funds कार्ड पर credited हो जाएँगे।

निम्न पते पर POST अनुरोध भेजें:
पैरामीटर प्रकार विवरण
card_id string जिस virtual card को आप top up करना चाहते हैं उसका identifier।
account_number string आपका आंतरिक खाता नंबर, जिससे top-up राशि काटी जाएगी।
amount number वह राशि जिसे आप virtual card में credit करना चाहते हैं।

Response parameters:

पैरामीटर प्रकार विवरण
status string अनुरोध निष्पादन की स्थिति (उदाहरण के लिए, सफल अनुरोध के लिए "success")।
code string Response code (उदाहरण के लिए, सफल अनुरोध के लिए "REQUEST_SUCCESS")।
transaction_number string कार्ड top-up से संबंधित transaction number।
<?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';
    }

?>

कार्ड से धनवापसी

यह API विधि virtual card से आपके आंतरिक खाते में धनवापसी शुरू करने की अनुमति देती है।

धन उसी खाते में वापस किया जाता है जिससे कार्ड जारी किया गया था।

आपको कार्ड tariffs के अनुसार refund fee काटकर राशि प्राप्त होगी।

उदाहरण के लिए, यदि आप $10 की धनवापसी करते हैं और refund fee 3% है, तो $10 × 3% = $0.30 शुल्क के रूप में काटा जाएगा और आपके खाते में $9.70 जमा होगा।

निम्न पते पर POST अनुरोध भेजें:
पैरामीटर प्रकार विवरण
card_id string जिस कार्ड से धनवापसी की जा रही है उसका अद्वितीय identifier।
amount number धनवापसी राशि जिसे आंतरिक खाते में transfer करना है।

Response parameters:

पैरामीटर प्रकार विवरण
status string अनुरोध निष्पादन की स्थिति (उदाहरण के लिए, सफल अनुरोध के लिए "success")।
code string Response code (उदाहरण के लिए, सफल अनुरोध के लिए "REQUEST_SUCCESS")।
transaction_number string कार्ड से की गई धनवापसी से संबंधित अद्वितीय transaction number।
<?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';
    }

?>

कार्ड संचालन इतिहास

यह API विधि आपके virtual card के साथ की गई सभी operations की पूरी सूची तक पहुँच प्रदान करती है।

निम्न पते पर POST अनुरोध भेजें:
पैरामीटर प्रकार विवरण
card_id string जिस virtual card के लिए आप operation history प्राप्त करना चाहते हैं उसका अद्वितीय identifier।
per_page number एक पृष्ठ पर प्रदर्शित होने वाले रिकॉर्ड की संख्या।
page number Pagination के लिए पृष्ठ नंबर।

Response parameters:

पैरामीटर प्रकार विवरण
status string अनुरोध निष्पादन की स्थिति (उदाहरण के लिए, सफल अनुरोध के लिए "success")।
code string Response code (उदाहरण के लिए, सफल अनुरोध के लिए "REQUEST_SUCCESS")।
count number इस कार्ड की operation history में कुल transactions की संख्या।
transactions array Objects की सूची, जिसमें प्रत्येक transaction के details होते हैं, जिसमें date, amount और operation type शामिल हैं।
<?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';
    }

?>

कार्ड बैलेंस अपडेट करें

यह API विधि virtual card balance update शुरू करने की अनुमति देती है, जिससे कार्ड पर funds की वर्तमान स्थिति का up-to-date डेटा प्राप्त होता है।

निम्न पते पर POST अनुरोध भेजें:
पैरामीटर प्रकार विवरण
card_id string जिस virtual card के लिए आप balance update करना चाहते हैं उसका अद्वितीय identifier।

Response parameters:

पैरामीटर प्रकार विवरण
status string अनुरोध निष्पादन की स्थिति (उदाहरण के लिए, सफल अनुरोध के लिए "success")।
code string Response code (उदाहरण के लिए, सफल अनुरोध के लिए "REQUEST_SUCCESS")।
balance number Update के बाद virtual card का वर्तमान balance, जो उपलब्ध funds दिखाता है।
<?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';
    }

?>

कार्ड पुष्टि कोड

यह API विधि virtual card operations को authorize करने के लिए आवश्यक confirmation codes की सूची प्राप्त करने की अनुमति देती है।

निम्न पते पर POST अनुरोध भेजें:
पैरामीटर प्रकार विवरण
card_id string जिस virtual card के लिए operation confirmation codes आवश्यक हैं उसका अद्वितीय identifier।

Response parameters:

पैरामीटर प्रकार विवरण
status string अनुरोध निष्पादन की स्थिति (उदाहरण के लिए, सफल अनुरोध के लिए "success")।
code string Response code (उदाहरण के लिए, सफल अनुरोध के लिए "REQUEST_SUCCESS")।
codes array कार्ड transactions को पूरा करने के लिए आवश्यक confirmation codes की सूची।
<?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';
    }

?>

कार्ड ब्लॉक करें

यह API विधि virtual card को block करने की अनुमति देती है, जिससे उसका आगे उपयोग बंद हो जाता है।

यदि कार्ड balance में funds हैं, तो वे refund tariffs के अनुसार उसी आंतरिक खाते में वापस किए जाएँगे जिससे कार्ड जारी किया गया था।

हालाँकि, यदि fee काटने के बाद refund amount न्यूनतम refund amount से कम है, तो ऐसे funds कार्ड balance से debit कर दिए जाएँगे।

निम्न पते पर POST अनुरोध भेजें:
पैरामीटर प्रकार विवरण
card_id string जिस virtual card को आप block करना चाहते हैं उसका अद्वितीय identifier।

Response parameters:

पैरामीटर प्रकार विवरण
status string अनुरोध निष्पादन की स्थिति (उदाहरण के लिए, सफल अनुरोध के लिए "success")।
code string Response code (उदाहरण के लिए, सफल अनुरोध के लिए "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';
    }

?>

कार्ड बंद करें

यह API विधि virtual card को close करने की अनुमति देती है, जिससे उसका आगे उपयोग बंद हो जाता है।

यह ध्यान रखना महत्वपूर्ण है कि यदि कार्ड पर funds शेष हैं, तो इस विधि का उपयोग कार्ड बंद करने के लिए नहीं किया जा सकता।

निम्न पते पर POST अनुरोध भेजें:
पैरामीटर प्रकार विवरण
card_id string जिस virtual card को आप close करना चाहते हैं उसका अद्वितीय identifier।

Response parameters:

पैरामीटर प्रकार विवरण
status string अनुरोध निष्पादन की स्थिति (उदाहरण के लिए, सफल अनुरोध के लिए "success")।
code string Response code (उदाहरण के लिए, सफल अनुरोध के लिए "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';
    }

?>

कार्ड ब्लॉकिंग स्थितियाँ

संभावित card blocking statuses और उनके अर्थों का विवरण।

स्थिति विवरण
terms_violation उपयोग की शर्तों का उल्लंघन
insufficient_funds अपर्याप्त funds
unauthorized_topup अनधिकृत top-up प्रयास
high_refund_rate उच्च refund percentage
prebilling प्रथम billing
subscription_delay Subscription fee में देरी
invalid_personal_data गलत या अधूरा व्यक्तिगत डेटा
illegal_activity अवैध कार्यों के प्रयास
verification_issues Verification समस्याएँ
high_risk उच्च risk level
terms_change कार्ड शर्तों में बदलाव
inactivity निष्क्रियता
internal_errors आंतरिक त्रुटियाँ
regulatory_requirements Regulatory requirements
user_blocked ग्राहक ने कार्ड block किया
not_blocked Block नहीं है

Webhook Events

जैसे ही भुगतान स्थिति "Paid" में बदलती है, Pay2.House आपके merchant के लिए पहले से सेट किए गए Webhook URL पर webhook फ़ॉर्मेट में notifications automatically भेजता है।

हम notification 100 बार भेजेंगे, जब तक हमें HTTP status 200 और response text "OK" प्राप्त नहीं हो जाता।

इसके अलावा, हमारा सिस्टम request header में "Pay2-House-Signature" parameter को unique token के साथ automatically शामिल करता है। आप इस token का उपयोग request की authenticity verify करने के लिए कर सकते हैं।

<?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');
?>

संभावित त्रुटियाँ

API का उपयोग करते समय होने वाली कुछ संभावित त्रुटियाँ यहाँ दी गई हैं।

त्रुटि कोड त्रुटि विवरण
INVALID_TOKEN Signature token invalid या missing है।
INVALID_API_KEY API key invalid या missing है।
API_KEY_NOT_FOUND निर्दिष्ट API key नहीं मिली।
INACTIVE_API_KEY प्रदान की गई API key inactive है।
SIGNATURE_DECODING_FAILED Signature decode करते समय त्रुटि।
INVALID_SIGNATURE_DATA Signature data invalid है।
EXPIRED_SIGNATURE Signature expired हो गई है।
MISMATCHED_SIGNATURE_ISSUER Key ID invalid या missing है।
INVALID_MERCHANT_ID Merchant ID invalid या missing है।
MERCHANT_ID_NOT_FOUND Merchant ID नहीं मिला।
ACCESS_DENIED_MERCHANT निर्दिष्ट Merchant ID तक access denied है।
INVALID_EXTERNAL_NUMBER External payment number invalid या missing है।
INVALID_AMOUNT Invalid amount।
INVALID_CURRENCY_CODE Invalid currency code।
INVALID_DESCRIPTION Payment description invalid या missing है।
SIGNATURE_VERIFICATION_FAILED त्रुटि के कारण signature verification failed।
INVALID_RETURN_URL Successful payment के बाद return URL invalid या missing है।
INVALID_CANCEL_URL Payment cancellation URL invalid या missing है।
INVALID_PAYER_EMAIL Customer email address invalid है।
INVALID_COMMENT Comment invalid या missing है।
INSUFFICIENT_SENDER_BALANCE Sender account में insufficient balance।
AMOUNT_EXCEEDS_SENDER_BALANCE Transfer amount sender account के available balance से अधिक है।
SENDER_ACCOUNT_NOT_FOUND Sender account नहीं मिला।
INVALID_SENDER_ACCOUNT Invalid sender account।
RECIPIENT_ACCOUNT_NOT_FOUND Recipient account नहीं मिला।
INVALID_RECIPIENT_ACCOUNT Invalid recipient account।
DIFFERENT_CURRENCY_CODES Sender और recipient accounts की currencies अलग-अलग हैं।
INVALID_TRANSFER Sender और recipient accounts समान नहीं हो सकते।
PROVIDER_NOT_FOUND Payment method नहीं मिला या inactive है।
PROVIDER_OPTION_NOT_FOUND Payment method options नहीं मिले।
AMOUNT_BELOW_MINIMUM Transfer amount minimum threshold से कम है।
AMOUNT_EXCEEDS_MAXIMUM Transfer amount maximum limit से अधिक है।
INSUFFICIENT_BALANCE_AFTER_FEE Fee को ध्यान में रखने के बाद sender account में insufficient balance।
INVALID_NAME_WALLET Account name invalid या missing है।
INVALID_PAYMENT_METHOD Invalid payment method।
PAY2_HOUSE_NOT_ENABLED Pay2.House payment method आपके merchant के लिए उपलब्ध नहीं है।
USDT_TRC20_NOT_ENABLED Tether USDT payment method आपके merchant के लिए उपलब्ध नहीं है।
CARDS_NOT_ENABLED CARDS payment method आपके merchant के लिए उपलब्ध नहीं है।
TRON_ACCOUNT_CREATION_ERROR TRON account बनाने में त्रुटि।
INVALID_INVOICE_NUMBER Account number format invalid है।
INVOICE_NOT_FOUND Account नहीं मिला।
MAX_WALLETS_REACHED आपके account के लिए allowed accounts की maximum संख्या पहुँच गई है।
MERCHANT_NOT_APPROVED Merchant payment processing के लिए approved नहीं है।
INVALID_DEADLINE_SECONDS Payment expiration तक time interval का value invalid है।
USER_DELETED User deleted हो गया है।
USER_BANNED User blocked है।
USER_TEMPORARILY_BLOCKED User temporarily blocked है।
USER_NOT_FOUND User नहीं मिला।
INVALID_PER_PAGE "per_page" parameter का value invalid है। value 10 से 100 के बीच होना चाहिए।
INVALID_PAGE "page" parameter का value invalid है। value positive integer होना चाहिए।
INVALID_STATUS Invalid status।
INSUFFICIENT_BALANCE इस operation को execute करने के लिए account में insufficient funds हैं।
INVALID_FIRST_NAME पहला नाम गलत बताया गया है।
INVALID_LAST_NAME उपनाम गलत बताया गया है।
INVALID_SUR_NAME मध्य नाम गलत बताया गया है।
INVALID_ADDRESS आवासीय पता गलत बताया गया है।
INVALID_CITY निवास शहर गलत बताया गया है।
INVALID_REGION निवास क्षेत्र गलत बताया गया है।
INVALID_POST_CODE Postal code गलत बताया गया है।
INVALID_EMAIL ईमेल गलत बताया गया है।
INVALID_DATE_BIRTH जन्मतिथि गलत बताई गई है।
FORBIDDEN_COUNTRY देश उपयोग के लिए allowed नहीं है।
INVALID_PHONE_NUMBER Phone number गलत बताया गया है।
INVALID_COUNTRY_CODE Country code गलत बताया गया है।
VERIFICATION_REQUIRED Operation करने के लिए account verification आवश्यक है।
CARD_ISSUANCE_FAILED Card issue नहीं किया जा सका।
INVALID_BIN_NUMBER BIN number invalid या missing है।
ACCOUNT_NOT_FOUND निर्दिष्ट account नहीं मिला।
INVALID_ACCOUNT_NUMBER Account number invalid या missing है।
CARD_NOT_FOUND Card नहीं मिला।
CARD_BLOCKED Card blocked है।
CARD_CLOSED Card closed है।
CARD_AWAITING Card issue process में है।
CARD_REFUND_FAILED Card refund failed।
CARD_BLOCKING_FAILED Internal system error के कारण card blocking failed।
CARD_DETAILS_FAILED Card details प्राप्त नहीं किए जा सके।
CARD_BALANCE_NOT_ZERO Card बंद नहीं किया जा सकता, क्योंकि उस पर funds शेष हैं।
CARD_CLOSING_FAILED Internal system error के कारण card closing failed।
REFUND_NOT_ALLOWED Refund allowed नहीं है।
CARD_HAS_NO_BALANCE Card में balance नहीं है।
CARD_REFUND_MIN_AMOUNT Minimum refund amount पूरा नहीं हुआ।
CARD_REFUND_MAX_AMOUNT Refund amount maximum limit से अधिक है।
CARD_REFUND_COST_GREATER Fee काटने के बाद refund amount refund के लिए minimum allowed amount से कम है।
CARD_REFUND_AMOUNT_ZERO Refund amount zero से अधिक होना चाहिए।
ACCOUNT_DELETED निर्दिष्ट account deleted है।
CARD_MINIMUM_AMOUNT Top-up amount minimum amount से अधिक होना चाहिए।
CARD_MAXIMUM_AMOUNT Top-up amount maximum allowed amount से अधिक है।
CARD_BALANCE_REFRESH_FAILED Card balance update नहीं किया जा सका।
CARD_HISTORY_REFRESH_FAILED Card operation history update नहीं की जा सकी।
SENDER_ACCOUNT_DELETED Funds transfer संभव नहीं है क्योंकि sender account deleted या deactivated है।
RECIPIENT_ACCOUNT_DELETED Funds transfer संभव नहीं है क्योंकि recipient account deleted या deactivated है।
TRANSACTION_NOT_PROCESSED Transaction error या internal restrictions के कारण process नहीं हुई।
TRANSACTION_NOT_FOUND Transaction system में नहीं मिली।
INVALID_TRANSACTION_NUMBER Transaction number invalid या missing है।
INVALID_DATE_RANGE गलत date range दिया गया है। format और logic की शुद्धता जाँचें (start date end date से बड़ी नहीं हो सकती)।
वेबसाइट बेहतर बनाने के लिए हम कुकीज़ इस्तेमाल करते हैं। इसका उपयोग जारी रखकर आप हमारी गोपनीयता नीति और सेवा के नियमों से सहमत होते हैं।