Зв'язатися з менеджером
З чого почати?
Pay2.House Увійти

API

Pay2.House

Створити ключ API

Щоб створити ключ API, перейдіть за посиланням: https://pay2.house/keys/prepare

Авторизація запитів

Pay2.House використовує JSON Web Tokens (JWT) для авторизації запитів до API.

Для отримання додаткової інформації про 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», що означає, що клієнт може самостійно вибрати метод оплати.

Параметри відповіді:

Параметр Тип Опис
status string Статус виконання запиту (наприклад, "success" для успішно виконаного запиту).
code string Код відповіді (наприклад, "REQUEST_SUCCESS" для успішного запиту).
invoice_number string Унікальний номер інвойсу, який ідентифікує платіжну транзакцію в системі.
approval_url string URL-посилання, на яке необхідно перенаправити клієнта для завершення платежу.
<?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 Номер вашого інвойсу.

Параметри відповіді:

Параметр Тип Опис
status string Статус виконання запиту (наприклад, "success" для успішно виконаного запиту).
code string Код відповіді (наприклад, "REQUEST_SUCCESS" для успішного запиту).
invoice_number string Унікальний номер інвойсу, який ідентифікує платіжну транзакцію в системі.
currency_code string Код валюти платежу (наприклад, USD для долара, EUR для євро, USDT для Tether).
currency_symbol string Символ валюти (наприклад, "$" для долара США).
external_number string Зовнішній номер, пов’язаний із платіжною транзакцією.
description string Опис платіжної транзакції або інвойсу.
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 Коментар до переказу.

Параметри відповіді:

Параметр Тип Опис
status string Статус виконання запиту (наприклад, "success" для успішно виконаного запиту).
code string Код відповіді (наприклад, "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 Унікальний номер транзакції, який використовується для ідентифікації конкретного переказу.

Параметри відповіді:

Параметр Тип Опис
status string Статус виконання запиту (наприклад, "success" для успішно виконаного запиту).
code string Код відповіді (наприклад, "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

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 Номер сторінки для пагінації.
transaction_type string Фільтр за типом транзакції (incoming - зарахування, withdrawal - списання).
status string

Фільтр за статусом транзакції.

В обробці: in_processing

Підтверджено: confirmed

Помилка: error
date_range string Фільтр для вибірки за діапазоном дат (у форматі DD.MM.YYYY - DD.MM.YYYY), також використовується для фільтрації.

Параметри відповіді:

Параметр Тип Опис
status string Статус виконання запиту (наприклад, "success" для успішно виконаного запиту).
code string Код відповіді (наприклад, "REQUEST_SUCCESS" для успішного запиту).
count number Загальна кількість транзакцій, що відповідають запиту.
transactions array

Масив об’єктів транзакцій, що містить інформацію про кожну транзакцію (наприклад, ідентифікатор, статус, баланс тощо).

Дивіться опис усіх полів у розділі інформація про переказ.
<?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 Прапорець видалення рахунку. Значення 0 вказує на активний рахунок, а значення 1 — на видалений або заблокований рахунок.
currency_code string Код валюти для фільтрації рахунків (наприклад, "USD" для долара, "EUR" для євро, "USDT" для Tether).

Параметри відповіді:

Параметр Тип Опис
status string Статус виконання запиту (наприклад, "success" для успішно виконаного запиту).
code string Код відповіді (наприклад, "REQUEST_SUCCESS" для успішного запиту).
count number Загальна кількість рахунків, що відповідають запиту.
wallets array

Масив об’єктів рахунків, що містить інформацію про кожен рахунок (наприклад, ідентифікатор, статус, баланс тощо).

Дивіться опис усіх полів у розділі інформація про рахунок.
<?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).

Параметри відповіді:

Параметр Тип Опис
status string Статус виконання запиту (наприклад, "success" для успішно виконаного запиту).
code string Код відповіді (наприклад, "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 Номер вашого рахунку.

Параметри відповіді:

Параметр Тип Опис
status string Статус виконання запиту (наприклад, "success" для успішно виконаного запиту).
code string Код відповіді (наприклад, "REQUEST_SUCCESS" для успішного запиту).
time_created number Час створення рахунку у форматі Unix timestamp.
date_created string Дата створення рахунку у форматі YYYY-MM-DD.
delete_flag number Прапорець видалення (0 — не видалено, 1 — видалено).
account_number string Номер рахунку.
currency_code string Код валюти рахунку (наприклад, USD для долара, EUR для євро, USDT для Tether).
currency_symbol string Символ валюти (наприклад, "$" для долара США).
name string Назва рахунку.
balance number Поточний баланс на рахунку.
bonus number Розмір бонусних коштів, доступних на рахунку, якщо застосовується.
trc20_address string TRC-20 адреса для токенів, якщо застосовується.
<?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 дозволяє отримати детальну виписку за вибраним рахунком, включно з інформацією про всі транзакції та зміни балансу.

Виконайте POST-запит за такою адресою:
Параметр Тип Опис
account_number string Номер вашого рахунку.

Параметри відповіді:

Параметр Тип Опис
status string Статус виконання запиту (наприклад, "success" для успішно виконаного запиту).
code string Код відповіді (наприклад, "REQUEST_SUCCESS" для успішного запиту).
download_url string URL для завантаження файлу з випискою за рахунком у форматі CSV.
<?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 дозволяє отримати список доступних BIN для випуску віртуальних карток у системі Pay2.House.

Виконайте POST-запит за такою адресою:
Параметр Тип Опис
currency_code string Код валюти BIN (наприклад, USD, EUR).
country_code string Код країни BIN у форматі ISO 3166-1 alpha-2 (наприклад, US, HK).
card_type string

Тип картки.

Віртуальна: virtual

Фізична: physical
card_network string

Платіжна система.

Visa: visa

MasterCard: mastercard
card_product_type string

Тип продукту картки.

Персональна: personal

Стандартна: standard

Параметри відповіді:

Параметр Тип Опис
status string Статус виконання запиту (наприклад, "success" для успішно виконаного запиту).
code string Код відповіді (наприклад, "REQUEST_SUCCESS" для успішного запиту).
count number Загальна кількість BIN, що відповідають запиту.
bins array Масив об’єктів BIN, що містить інформацію про кожен BIN.
bin string Банківський ідентифікаційний номер.
currency_code string Код валюти BIN (наприклад, USD, EUR).
country_code string Код країни BIN у форматі ISO 3166-1 alpha-2 (наприклад, US, HK).
card_type string Платіжна система (наприклад, visa, mastercard).
card_product_type string Тип продукту картки (наприклад, standard, personal).
card_tier string Рівень картки (наприклад, premium, shared).
verification_required number Чи потрібна верифікація (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.

Виконайте POST-запит за такою адресою:
Параметр Тип Опис
per_page number Кількість записів, які буде показано на одній сторінці.
page number Номер сторінки для пагінації.
status string

Фільтр за статусом карток.

Активна: active

Заблокована: blocked

Закрита: closed

Очікує випуску: awaiting

Параметри відповіді:

Параметр Тип Опис
status string Статус виконання запиту (наприклад, "success" для успішно виконаного запиту).
code string Код відповіді (наприклад, "REQUEST_SUCCESS" для успішного запиту).
count number Загальна кількість карток, що відповідають запиту.
cards array

Масив об’єктів карток, що містить інформацію про кожну картку (наприклад, ідентифікатор, статус, баланс тощо).

Дивіться опис усіх полів у розділі інформація про картку.
<?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.

Виконайте 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 Поштовий індекс для адреси проживання.
email string Електронна пошта держателя картки.
country_code string Код країни за стандартом ISO 3166-1 alpha-2 (наприклад, "US" для Сполучених Штатів).
bin_number string Банківський ідентифікаційний номер (BIN) картки. Необхідно запитати через тікети в технічній підтримці.
renewal_payment_flag number Цей прапорець вказує, чи можна списувати кошти для продовження картки з основного рахунку Pay2.House у разі нестачі коштів на картці (1 - так, 0 - ні).

Параметри відповіді:

Параметр Тип Опис
status string Статус виконання запиту (наприклад, "success" для успішно виконаного запиту).
code string Код відповіді (наприклад, "REQUEST_SUCCESS" для успішного запиту).
card_number string Номер випущеної картки.
card_id string Унікальний ідентифікатор картки в системі, що використовується для подальших операцій.
<?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 дозволяє отримати детальну інформацію про віртуальну картку, включно з номером картки, статусом, датою випуску та іншими пов’язаними даними.

Виконайте POST-запит за такою адресою:
Параметр Тип Опис
card_id string Унікальний ідентифікатор картки в системі, що використовується для отримання її деталей.

Параметри відповіді:

Параметр Тип Опис
status string Статус виконання запиту (наприклад, "success" для успішно виконаного запиту).
code string Код відповіді (наприклад, "REQUEST_SUCCESS" для успішного запиту).
card_name string Назва картки, вказана під час її випуску.
card_number string Номер випущеної картки.
card_id string Унікальний ідентифікатор картки в системі.
cvv string Код безпеки картки, необхідний для авторизації.
expiration_date string Дата закінчення строку дії картки у форматі MM/YY.
password string 3DS пароль для додаткової безпеки під час онлайн-транзакцій.
currency_code string Код валюти, що використовується для операцій із карткою.
currency_symbol string Символ валюти (наприклад: $ або €).
time_created number Час створення картки у форматі Unix timestamp.
date_created string Дата створення картки у форматі YYYY-MM-DD.
date_renewal string Дата наступного списання за продовження картки у форматі YYYY-MM-DD.
time_renewal number Час наступного списання за продовження картки у форматі Unix timestamp.
email string Адреса електронної пошти, вказана під час випуску картки.
phone_number string Номер телефону, вказаний під час випуску картки.
address_line_1 string Адреса проживання, вказана під час випуску картки.
city string Місто проживання, вказане під час випуску картки.
country_code string Код країни за стандартом ISO 3166-1 alpha-2 (наприклад, "US" для Сполучених Штатів).
first_name string Ім’я власника картки.
last_name string Прізвище власника картки.
sur_name string По батькові власника картки.
date_birth string Дата народження власника картки у форматі DD.MM.YYYY.
post_code string Поштовий індекс.
card_status string

Статус картки.

Активна: active

Заблокована: blocked

Закрита: closed

Очікує випуску: awaiting
balance number Поточний баланс картки.
issuance_cost number Вартість випуску картки.
renewal_cost number Вартість продовження картки.
recharge_cost number Комісія за поповнення картки.
recharge_type string Тип комісії за поповнення картки (може бути "fixed" для фіксованої комісії або "percent" для відсоткової комісії). Значення комісії береться з параметра recharge_cost.
account_refund_cost number Комісія за повернення коштів із картки.
account_refund_type string Тип комісії за повернення коштів із картки (може бути "fixed" для фіксованої комісії або "percent" для відсоткової комісії). Значення комісії береться з параметра 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 Унікальний ідентифікатор картки в системі, що використовується для отримання її деталей.
name string Нова назва віртуальної картки. Максимальна довжина — 100 символів.

Параметри відповіді:

Параметр Тип Опис
status string Статус виконання запиту (наприклад, "success" для успішно виконаного запиту).
code string Код відповіді (наприклад, "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 дозволяє поповнити баланс віртуальної картки за допомогою вашого внутрішнього рахунку.

Надходження коштів на картку буде здійснено протягом 2-3 хвилин після створення запиту на поповнення.

Виконайте POST-запит за такою адресою:
Параметр Тип Опис
card_id string Ідентифікатор віртуальної картки, яку ви хочете поповнити.
account_number string Номер вашого внутрішнього рахунку, з якого буде списано суму поповнення.
amount number Сума, яку ви хочете зарахувати на віртуальну картку.

Параметри відповіді:

Параметр Тип Опис
status string Статус виконання запиту (наприклад, "success" для успішно виконаного запиту).
code string Код відповіді (наприклад, "REQUEST_SUCCESS" для успішного запиту).
transaction_number string Номер транзакції, пов’язаної з поповненням картки.
<?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 дозволяє ініціювати повернення коштів із віртуальної картки на ваш внутрішній рахунок.

Повернення коштів здійснюється на той самий рахунок, з якого була випущена картка.

Ви отримаєте суму за вирахуванням комісії за повернення, згідно з тарифами картки.

Наприклад, якщо ви робите повернення $10 і комісія за повернення становить 3%, то $10 × 3% = $0.30 буде утримано як комісію, і на ваш рахунок буде зараховано $9.70.

Виконайте POST-запит за такою адресою:
Параметр Тип Опис
card_id string Унікальний ідентифікатор картки, з якої здійснюється повернення коштів.
amount number Сума повернення, яку необхідно переказати на внутрішній рахунок.

Параметри відповіді:

Параметр Тип Опис
status string Статус виконання запиту (наприклад, "success" для успішно виконаного запиту).
code string Код відповіді (наприклад, "REQUEST_SUCCESS" для успішного запиту).
transaction_number string Унікальний номер транзакції, пов’язаної з виконаним поверненням коштів із картки.
<?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 надає доступ до повного списку операцій, виконаних із вашою віртуальною карткою.

Виконайте POST-запит за такою адресою:
Параметр Тип Опис
card_id string Унікальний ідентифікатор віртуальної картки, для якої ви хочете отримати історію операцій.
per_page number Кількість записів, які буде показано на одній сторінці.
page number Номер сторінки для пагінації.

Параметри відповіді:

Параметр Тип Опис
status string Статус виконання запиту (наприклад, "success" для успішно виконаного запиту).
code string Код відповіді (наприклад, "REQUEST_SUCCESS" для успішного запиту).
count number Загальна кількість транзакцій в історії операцій за цією карткою.
transactions array Список об’єктів, що містять деталі кожної транзакції, включно з датою, сумою та типом операції.
<?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 дозволяє ініціювати оновлення балансу віртуальної картки, забезпечуючи отримання актуальних даних про поточний стан коштів на картці.

Виконайте POST-запит за такою адресою:
Параметр Тип Опис
card_id string Унікальний ідентифікатор віртуальної картки, для якої ви хочете оновити баланс.

Параметри відповіді:

Параметр Тип Опис
status string Статус виконання запиту (наприклад, "success" для успішно виконаного запиту).
code string Код відповіді (наприклад, "REQUEST_SUCCESS" для успішного запиту).
balance number Поточний баланс віртуальної картки після оновлення, що відображає доступні кошти.
<?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 дозволяє отримати список кодів підтвердження, необхідних для авторизації операцій із віртуальною карткою.

Виконайте POST-запит за такою адресою:
Параметр Тип Опис
card_id string Унікальний ідентифікатор віртуальної картки, для якої потрібно отримати коди підтвердження операцій.

Параметри відповіді:

Параметр Тип Опис
status string Статус виконання запиту (наприклад, "success" для успішно виконаного запиту).
code string Код відповіді (наприклад, "REQUEST_SUCCESS" для успішного запиту).
codes array Список кодів підтвердження, необхідних для завершення транзакцій із карткою.
<?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 дозволяє заблокувати віртуальну картку, припиняючи можливість її подальшого використання.

Якщо на балансі картки є кошти, вони будуть повернені на внутрішній рахунок, з якого була випущена картка, відповідно до тарифів на повернення.

Однак якщо сума повернення за вирахуванням комісії виявляється меншою за мінімальну суму для повернення, такі кошти будуть списані з балансу картки.

Виконайте POST-запит за такою адресою:
Параметр Тип Опис
card_id string Унікальний ідентифікатор віртуальної картки, яку ви хочете заблокувати.

Параметри відповіді:

Параметр Тип Опис
status string Статус виконання запиту (наприклад, "success" для успішно виконаного запиту).
code string Код відповіді (наприклад, "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 дозволяє закрити віртуальну картку, припиняючи можливість її подальшого використання.

Важливо зазначити, що цей метод не може бути використаний для закриття картки, якщо на ній залишаються кошти.

Виконайте POST-запит за такою адресою:
Параметр Тип Опис
card_id string Унікальний ідентифікатор віртуальної картки, яку ви хочете закрити.

Параметри відповіді:

Параметр Тип Опис
status string Статус виконання запиту (наприклад, "success" для успішно виконаного запиту).
code string Код відповіді (наприклад, "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';
    }

?>

Статуси блокування картки

Опис можливих статусів блокування картки та їхніх значень.

Статус Опис
terms_violation Порушення умов використання
insufficient_funds Нестача коштів
unauthorized_topup Несанкціоновані спроби поповнення
high_refund_rate Високий відсоток повернень
prebilling Перший білінг
subscription_delay Затримка абонентської плати
invalid_personal_data Невірні або неповні персональні дані
illegal_activity Спроби незаконних дій
verification_issues Проблеми з верифікацією
high_risk Високий ступінь ризику
terms_change Зміна умов картки
inactivity Неактивність
internal_errors Внутрішні помилки
regulatory_requirements Регуляторні вимоги
user_blocked Клієнт заблокував картку
not_blocked Не заблоковано

Webhook Events

Щойно статус платежу змінюється на "Оплачено", Pay2.House автоматично надсилає повідомлення у форматі вебхука на ваш заздалегідь вказаний Webhook URL, який ви налаштовуєте для вашого мерчанта.

Ми надсилатимемо повідомлення 100 разів, доки не отримаємо HTTP-статус 200 і текст відповіді "OK".

Крім того, наша система автоматично включає в заголовок запиту параметр "Pay2-House-Signature" з унікальним токеном. Ви можете використовувати цей токен для перевірки автентичності запиту.

<?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 Невірний або відсутній токен підпису.
INVALID_API_KEY Невірний або відсутній ключ API.
API_KEY_NOT_FOUND Вказаний ключ API не знайдено.
INACTIVE_API_KEY Наданий ключ API неактивний.
SIGNATURE_DECODING_FAILED Помилка під час декодування підпису.
INVALID_SIGNATURE_DATA Недопустимі дані підпису.
EXPIRED_SIGNATURE Строк дії підпису закінчився.
MISMATCHED_SIGNATURE_ISSUER Невірний або відсутній ідентифікатор Key ID.
INVALID_MERCHANT_ID Невірний або відсутній ідентифікатор Merchant ID.
MERCHANT_ID_NOT_FOUND Merchant ID не знайдено.
ACCESS_DENIED_MERCHANT Доступ до вказаного Merchant ID заборонено.
INVALID_EXTERNAL_NUMBER Невірний або відсутній зовнішній номер платежу.
INVALID_AMOUNT Недопустима сума.
INVALID_CURRENCY_CODE Недопустимий код валюти.
INVALID_DESCRIPTION Невірний або відсутній опис платежу.
SIGNATURE_VERIFICATION_FAILED Перевірка підпису не вдалася через помилку.
INVALID_RETURN_URL Недопустима або відсутня URL-адреса для повернення після успішного платежу.
INVALID_CANCEL_URL Недопустима або відсутня URL-адреса для скасування платежу.
INVALID_PAYER_EMAIL Недопустима адреса електронної пошти клієнта.
INVALID_COMMENT Невірний або відсутній коментар.
INSUFFICIENT_SENDER_BALANCE Недостатній баланс на рахунку відправника.
AMOUNT_EXCEEDS_SENDER_BALANCE Сума переказу перевищує доступний баланс на рахунку відправника.
SENDER_ACCOUNT_NOT_FOUND Рахунок відправника не знайдено.
INVALID_SENDER_ACCOUNT Недопустимий рахунок відправника.
RECIPIENT_ACCOUNT_NOT_FOUND Рахунок отримувача не знайдено.
INVALID_RECIPIENT_ACCOUNT Недопустимий рахунок отримувача.
DIFFERENT_CURRENCY_CODES У рахунків відправника й отримувача різні валюти.
INVALID_TRANSFER Рахунок відправника й отримувача не можуть бути однаковими.
PROVIDER_NOT_FOUND Платіжний метод не знайдено або він неактивний.
PROVIDER_OPTION_NOT_FOUND Опції платіжного методу не знайдено.
AMOUNT_BELOW_MINIMUM Сума переказу нижча за мінімальний поріг.
AMOUNT_EXCEEDS_MAXIMUM Сума переказу перевищує максимальний ліміт.
INSUFFICIENT_BALANCE_AFTER_FEE Недостатній баланс на рахунку відправника після врахування комісії.
INVALID_NAME_WALLET Невірна або відсутня назва рахунку.
INVALID_PAYMENT_METHOD Невірний метод оплати.
PAY2_HOUSE_NOT_ENABLED Метод оплати Pay2.House недоступний для вашого мерчанта.
USDT_TRC20_NOT_ENABLED Метод оплати Tether USDT недоступний для вашого мерчанта.
CARDS_NOT_ENABLED Метод оплати CARDS недоступний для вашого мерчанта.
TRON_ACCOUNT_CREATION_ERROR Помилка створення акаунта TRON.
INVALID_INVOICE_NUMBER Невірний формат номера рахунку.
INVOICE_NOT_FOUND Рахунок не знайдено.
MAX_WALLETS_REACHED Досягнуто максимально дозволеної кількості рахунків для вашого акаунта.
MERCHANT_NOT_APPROVED Мерчант не схвалений для обробки платежів.
INVALID_DEADLINE_SECONDS Невірне значення часового інтервалу до завершення строку оплати платежу.
USER_DELETED Користувача було видалено.
USER_BANNED Користувача заблоковано.
USER_TEMPORARILY_BLOCKED Користувача тимчасово заблоковано.
USER_NOT_FOUND Користувача не знайдено.
INVALID_PER_PAGE Недопустиме значення для параметра "per_page". Значення має бути від 10 до 100.
INVALID_PAGE Недопустиме значення для параметра "page". Значення має бути додатним цілим числом.
INVALID_STATUS Недопустимий статус.
INSUFFICIENT_BALANCE Недостатньо коштів на рахунку для виконання цієї операції.
INVALID_FIRST_NAME Ім’я вказано невірно.
INVALID_LAST_NAME Прізвище вказано невірно.
INVALID_SUR_NAME По батькові вказано невірно.
INVALID_ADDRESS Адресу проживання вказано невірно.
INVALID_CITY Місто проживання вказано невірно.
INVALID_REGION Регіон проживання вказано невірно.
INVALID_POST_CODE Поштовий індекс вказано невірно.
INVALID_EMAIL Електронну пошту вказано невірно.
INVALID_DATE_BIRTH Дату народження вказано невірно.
FORBIDDEN_COUNTRY Країна не дозволена для використання.
INVALID_PHONE_NUMBER Невірно вказаний номер телефону.
INVALID_COUNTRY_CODE Невірно вказаний код країни.
VERIFICATION_REQUIRED Потрібна верифікація акаунта для виконання операції.
CARD_ISSUANCE_FAILED Не вдалося випустити картку.
INVALID_BIN_NUMBER Невірний або відсутній BIN номер.
ACCOUNT_NOT_FOUND Вказаний рахунок не знайдено.
INVALID_ACCOUNT_NUMBER Невірний або відсутній номер рахунку.
CARD_NOT_FOUND Картку не знайдено.
CARD_BLOCKED Картку заблоковано.
CARD_CLOSED Картку закрито.
CARD_AWAITING Картка перебуває в процесі випуску.
CARD_REFUND_FAILED Повернення коштів із картки не вдалося.
CARD_BLOCKING_FAILED Блокування картки не вдалося через внутрішню помилку системи.
CARD_DETAILS_FAILED Не вдалося отримати деталі картки.
CARD_BALANCE_NOT_ZERO Картку не можна закрити, оскільки на ній залишилися кошти.
CARD_CLOSING_FAILED Закриття картки не вдалося через внутрішню помилку системи.
REFUND_NOT_ALLOWED Повернення коштів не дозволено.
CARD_HAS_NO_BALANCE У картки відсутній баланс.
CARD_REFUND_MIN_AMOUNT Мінімальної суми повернення не досягнуто.
CARD_REFUND_MAX_AMOUNT Сума повернення перевищує максимальний ліміт.
CARD_REFUND_COST_GREATER Сума повернення за вирахуванням комісії менша за мінімально допустиму для повернення.
CARD_REFUND_AMOUNT_ZERO Сума повернення має бути більшою за нуль.
ACCOUNT_DELETED Вказаний рахунок було видалено.
CARD_MINIMUM_AMOUNT Сума поповнення має бути вищою за мінімальну суму.
CARD_MAXIMUM_AMOUNT Сума поповнення перевищує максимально дозволену суму.
CARD_BALANCE_REFRESH_FAILED Не вдалося оновити баланс картки.
CARD_HISTORY_REFRESH_FAILED Не вдалося оновити історію операцій картки.
SENDER_ACCOUNT_DELETED Переказ коштів неможливий, оскільки рахунок відправника було видалено або деактивовано.
RECIPIENT_ACCOUNT_DELETED Переказ коштів неможливий, оскільки рахунок отримувача було видалено або деактивовано.
TRANSACTION_NOT_PROCESSED Транзакція не була оброблена через помилку або внутрішні обмеження.
TRANSACTION_NOT_FOUND Транзакцію не знайдено в системі.
INVALID_TRANSACTION_NUMBER Невірний або відсутній номер транзакції.
INVALID_DATE_RANGE Вказано некоректний діапазон дат. Перевірте правильність формату та логіки (дата початку не може бути більшою за дату завершення).
Ми використовуємо файли cookie для покращення роботи сайту. Продовжуючи користуватися сайтом, ви погоджуєтеся з політикою конфіденційності та правилами сервісу.