Contactar um gestor
Por onde começar?
Pay2.House Iniciar sessão

API

Pay2.House

Criar chave API

Para criar uma chave API, acesse o link: https://pay2.house/keys/prepare

Autorização de solicitações

Pay2.House utiliza JSON Web Tokens (JWT) para autorizar solicitações à API.

Para obter mais informações sobre JSON Web Tokens (JWT), recomenda-se consultar o guia sobre tokens JWT.

Para trabalhar com a API, você precisará instalar uma biblioteca que permita gerar e processar JSON Web Tokens (JWT). Recomenda-se usar a seguinte biblioteca: 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');
    }

?>

Criar pagamento

Este método da API permite inicializar um novo pagamento para efetuar um pagamento através do serviço de pagamento Pay2.House.

Execute uma solicitação POST para o seguinte endereço:
Parâmetro Tipo Descrição
external_number string Número único da transação ou do pedido.
amount number Valor do pagamento ou da transação.
currency_code string Código da moeda do pagamento (por exemplo, USD para dólar, EUR para euro, USDT para Tether).
merchant_id string Identificador do seu comerciante adicionado (Merchant ID).
description string Descrição do pagamento ou da transação.
deadline_seconds number Define o intervalo de tempo para o pagamento em segundos (por exemplo, 600 corresponde a um prazo de pagamento de 10 minutos). O valor máximo é 86400 segundos (1 dia).
return_url string Endereço URL para o qual o cliente deve ser retornado após a conclusão bem-sucedida do pagamento.
cancel_url string Endereço URL para o qual o cliente deve ser retornado em caso de cancelamento do pagamento.
handling_fee number Comissão adicional do pagamento.
payer_email string E-mail do cliente associado à transação de pagamento.
payment_method string Método de pagamento usado para esta transação. Métodos disponíveis: «PAY2_HOUSE», «USDT_TRC20», «CARDS». Por padrão «ALL», o que significa que o cliente pode escolher o método de pagamento por conta própria.

Parâmetros da resposta:

Parâmetro Tipo Descrição
status string Status de execução da solicitação (por exemplo, "success" para uma solicitação executada com sucesso).
code string Código de resposta (por exemplo, "REQUEST_SUCCESS" para uma solicitação bem-sucedida).
invoice_number string Número único da fatura que identifica a transação de pagamento no sistema.
approval_url string Link URL para o qual o cliente deve ser redirecionado para concluir o pagamento.
<?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);
    }

?>

Informações do pagamento

Este método da API permite solicitar informações sobre seu pagamento no sistema de pagamentos Pay2.House.

Execute uma solicitação POST para o seguinte endereço:
Parâmetro Tipo Descrição
merchant_id string Identificador do seu comerciante adicionado (Merchant ID).
invoice_number string Número da sua fatura.

Parâmetros da resposta:

Parâmetro Tipo Descrição
status string Status de execução da solicitação (por exemplo, "success" para uma solicitação executada com sucesso).
code string Código de resposta (por exemplo, "REQUEST_SUCCESS" para uma solicitação bem-sucedida).
invoice_number string Número único da fatura que identifica a transação de pagamento no sistema.
currency_code string Código da moeda do pagamento (por exemplo, USD para dólar, EUR para euro, USDT para Tether).
currency_symbol string Símbolo da moeda (por exemplo, "$" para dólar americano).
external_number string Número externo associado à transação de pagamento.
description string Descrição da transação de pagamento ou da fatura.
amount number Valor do pagamento na moeda especificada.
handling_fee number Valor da comissão pelo processamento do pagamento.
payment_status string

Status do pagamento.

Aguardando pagamento: pending

Em processamento: in_processing

Pago: paid

Cancelado: cancelled

Expirado: overdue

Parcialmente pago: partially

Erro de pagamento: error

Reembolso: 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';
    }

?>

Criar transferência

Este método da API permite inicializar uma nova transferência para uma conta interna no sistema Pay2.House.

Execute uma solicitação POST para o seguinte endereço:
Parâmetro Tipo Descrição
sender_account string Conta do remetente.
recipient_account string Conta do destinatário.
amount number Valor da transferência.
comment string Comentário da transferência.

Parâmetros da resposta:

Parâmetro Tipo Descrição
status string Status de execução da solicitação (por exemplo, "success" para uma solicitação executada com sucesso).
code string Código de resposta (por exemplo, "REQUEST_SUCCESS" para uma solicitação bem-sucedida).
transaction_number string Número único da transferência.
<?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';
    }

?>

Informações da transferência

Este método da API permite obter informações detalhadas sobre a transferência, incluindo status, valor, data e hora de execução, bem como outros dados relacionados.

Execute uma solicitação POST para o seguinte endereço:
Parâmetro Tipo Descrição
transaction_number string Número único da transação usado para identificar uma transferência específica.

Parâmetros da resposta:

Parâmetro Tipo Descrição
status string Status de execução da solicitação (por exemplo, "success" para uma solicitação executada com sucesso).
code string Código de resposta (por exemplo, "REQUEST_SUCCESS" para uma solicitação bem-sucedida).
transaction_number string Número único da transação.
time_created number Hora de criação da transação no formato Unix timestamp.
date_created string Data de criação da transação no formato YYYY-MM-DD.
sender_account string Número da conta do remetente dos fundos.
recipient_account string Número da conta do destinatário dos fundos.
amount number Valor transferido na transação.
fee_amount number Valor da comissão cobrada pela transação.
currency_code string Código da moeda da transação (por exemplo, USD para dólar, EUR para euro, USDT para Tether).
payment_method string

Método de pagamento usado para esta transação.

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

Método de confirmação da transação.

Confirmação por SMS: verification_phone

Google Authenticator: verification_code

Confirmação via API: verification_api

Sem confirmação: none
payment_type string

Tipo de pagamento.

Transferência interna: transfer

Recarga da conta: refill

Câmbio de moeda: exchange

Emissão de fatura: invoice

Merchant API: merchant
transaction_type string Tipo de transação (incoming - crédito, withdrawal - débito).
transaction_status string

Status da transação.

Em processamento: in_processing

Confirmado: confirmed

Erro: error
comment string Informações adicionais sobre a transação.
error_message string Mensagem de erro se a transação falhou.
<?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';
    }

?>

Histórico de transferências

Este método da API permite solicitar uma lista de transações, fornecendo informações sobre todas as transferências realizadas.

Execute uma solicitação POST para o seguinte endereço:
Parâmetro Tipo Descrição
per_page number Quantidade de registros que serão exibidos em uma página.
page number Número da página para paginação.
transaction_type string Filtro por tipo de transação (incoming - crédito, withdrawal - débito).
status string

Filtro por status da transação.

Em processamento: in_processing

Confirmado: confirmed

Erro: error
date_range string Filtro para seleção por intervalo de datas (no formato DD.MM.YYYY - DD.MM.YYYY), também usado para filtragem.

Parâmetros da resposta:

Parâmetro Tipo Descrição
status string Status de execução da solicitação (por exemplo, "success" para uma solicitação executada com sucesso).
code string Código de resposta (por exemplo, "REQUEST_SUCCESS" para uma solicitação bem-sucedida).
count number Quantidade total de transações correspondentes à solicitação.
transactions array

Array de objetos de transação contendo informações sobre cada transação (por exemplo, identificador, status, saldo etc.).

Veja a descrição de todos os campos na seção informações da transferência.
<?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';
    }

?>

Obter lista de contas

Este método da API permite solicitar uma lista de todas as contas associadas à sua conta no sistema Pay2.House.

Execute uma solicitação POST para o seguinte endereço:
Parâmetro Tipo Descrição
delete_flag number Indicador de exclusão da conta. O valor 0 indica uma conta ativa, e o valor 1 indica uma conta excluída ou bloqueada.
currency_code string Código da moeda para filtrar contas (por exemplo, "USD" para dólar, "EUR" para euro, "USDT" para Tether).

Parâmetros da resposta:

Parâmetro Tipo Descrição
status string Status de execução da solicitação (por exemplo, "success" para uma solicitação executada com sucesso).
code string Código de resposta (por exemplo, "REQUEST_SUCCESS" para uma solicitação bem-sucedida).
count number Quantidade total de contas correspondentes à solicitação.
wallets array

Array de objetos de conta contendo informações sobre cada conta (por exemplo, identificador, status, saldo etc.).

Veja a descrição de todos os campos na seção informações da conta.
<?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';
    }

?>

Criar conta

Este método da API permite criar contas únicas que podem ser usadas para pagamentos e transações dentro do sistema Pay2.House.

Execute uma solicitação POST para o seguinte endereço:
Parâmetro Tipo Descrição
name string Nome da conta.
currency_code string Código da moeda do pagamento (por exemplo, USD para dólar, EUR para euro, USDT para Tether).

Parâmetros da resposta:

Parâmetro Tipo Descrição
status string Status de execução da solicitação (por exemplo, "success" para uma solicitação executada com sucesso).
code string Código de resposta (por exemplo, "REQUEST_SUCCESS" para uma solicitação bem-sucedida).
account_number string Número da conta criada.
<?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';
    }

?>

Informações da conta

Este método da API permite solicitar informações sobre sua conta no sistema de pagamentos Pay2.House.

Execute uma solicitação POST para o seguinte endereço:
Parâmetro Tipo Descrição
account_number string Número da sua conta.

Parâmetros da resposta:

Parâmetro Tipo Descrição
status string Status de execução da solicitação (por exemplo, "success" para uma solicitação executada com sucesso).
code string Código de resposta (por exemplo, "REQUEST_SUCCESS" para uma solicitação bem-sucedida).
time_created number Hora de criação da conta no formato Unix timestamp.
date_created string Data de criação da conta no formato YYYY-MM-DD.
delete_flag number Indicador de exclusão (0 — não excluída, 1 — excluída).
account_number string Número da conta.
currency_code string Código da moeda da conta (por exemplo, USD para dólar, EUR para euro, USDT para Tether).
currency_symbol string Símbolo da moeda (por exemplo, "$" para dólar americano).
name string Nome da conta.
balance number Saldo atual da conta.
bonus number Valor dos fundos de bônus disponíveis na conta, se aplicável.
trc20_address string Endereço TRC-20 para tokens, se aplicável.
<?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';
    }

?>

Obter extrato da conta

Este método da API permite obter um extrato detalhado da conta selecionada, incluindo informações sobre todas as transações e alterações de saldo.

Execute uma solicitação POST para o seguinte endereço:
Parâmetro Tipo Descrição
account_number string Número da sua conta.

Parâmetros da resposta:

Parâmetro Tipo Descrição
status string Status de execução da solicitação (por exemplo, "success" para uma solicitação executada com sucesso).
code string Código de resposta (por exemplo, "REQUEST_SUCCESS" para uma solicitação bem-sucedida).
download_url string URL para baixar o arquivo do extrato da conta em formato 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';
    }

?>

Obter lista de BIN

Este método da API permite obter uma lista de BIN disponíveis para emissão de cartões virtuais no sistema Pay2.House.

Execute uma solicitação POST para o seguinte endereço:
Parâmetro Tipo Descrição
currency_code string Código da moeda do BIN (por exemplo, USD, EUR).
country_code string Código do país do BIN no formato ISO 3166-1 alpha-2 (por exemplo, US, HK).
card_type string

Tipo de cartão.

Virtual: virtual

Físico: physical
card_network string

Sistema de pagamento.

Visa: visa

MasterCard: mastercard
card_product_type string

Tipo de produto do cartão.

Pessoal: personal

Padrão: standard

Parâmetros da resposta:

Parâmetro Tipo Descrição
status string Status de execução da solicitação (por exemplo, "success" para uma solicitação executada com sucesso).
code string Código de resposta (por exemplo, "REQUEST_SUCCESS" para uma solicitação bem-sucedida).
count number Quantidade total de BIN correspondentes à solicitação.
bins array Array de objetos BIN contendo informações sobre cada BIN.
bin string Número de Identificação Bancária.
currency_code string Código da moeda do BIN (por exemplo, USD, EUR).
country_code string Código do país do BIN no formato ISO 3166-1 alpha-2 (por exemplo, US, HK).
card_type string Sistema de pagamento (por exemplo, visa, mastercard).
card_product_type string Tipo de produto do cartão (por exemplo, standard, personal).
card_tier string Nível do cartão (por exemplo, premium, shared).
verification_required number Se a verificação é necessária (1 — sim, 0 — não).
<?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';
    }

?>

Obter lista de cartões

Este método da API permite solicitar uma lista de cartões virtuais emitidos para sua conta no sistema Pay2.House.

Execute uma solicitação POST para o seguinte endereço:
Parâmetro Tipo Descrição
per_page number Quantidade de registros que serão exibidos em uma página.
page number Número da página para paginação.
status string

Filtro por status dos cartões.

Ativo: active

Bloqueado: blocked

Fechado: closed

Aguardando emissão: awaiting

Parâmetros da resposta:

Parâmetro Tipo Descrição
status string Status de execução da solicitação (por exemplo, "success" para uma solicitação executada com sucesso).
code string Código de resposta (por exemplo, "REQUEST_SUCCESS" para uma solicitação bem-sucedida).
count number Quantidade total de cartões correspondentes à solicitação.
cards array

Array de objetos de cartão contendo informações sobre cada cartão (por exemplo, identificador, status, saldo etc.).

Veja a descrição de todos os campos na seção informações do cartão.
<?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';
    }

?>

Emitir cartão

Este método da API permite emitir um novo cartão virtual no sistema Pay2.House.

Execute uma solicitação POST para o seguinte endereço:
Parâmetro Tipo Descrição
account_number string Número da sua conta da qual será debitada a taxa de emissão do cartão.
first_name string Nome do titular do cartão.
last_name string Sobrenome do titular do cartão.
sur_name string Nome do meio do titular do cartão.
date_birth string Data de nascimento do titular do cartão no formato DD.MM.YYYY.
phone_number string Número de telefone do titular do cartão, incluindo o código do país.
address string Endereço residencial do titular do cartão.
city string Cidade de residência do titular do cartão.
region string Região ou estado de residência do titular do cartão.
post_code string Código postal do endereço residencial.
email string E-mail do titular do cartão.
country_code string Código do país de acordo com o padrão ISO 3166-1 alpha-2 (por exemplo, "US" para os Estados Unidos).
bin_number string Número de Identificação Bancária (BIN) do cartão. Deve ser solicitado por meio de tickets no suporte técnico.
renewal_payment_flag number Este indicador mostra se os fundos para a renovação do cartão podem ser debitados da conta principal Pay2.House em caso de fundos insuficientes no cartão (1 - sim, 0 - não).

Parâmetros da resposta:

Parâmetro Tipo Descrição
status string Status de execução da solicitação (por exemplo, "success" para uma solicitação executada com sucesso).
code string Código de resposta (por exemplo, "REQUEST_SUCCESS" para uma solicitação bem-sucedida).
card_number string Número do cartão emitido.
card_id string Identificador único do cartão no sistema, usado para operações posteriores.
<?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';
    }

?>

Informações do cartão

Este método da API permite obter informações detalhadas sobre um cartão virtual, incluindo número do cartão, status, data de emissão e outros dados relacionados.

Execute uma solicitação POST para o seguinte endereço:
Parâmetro Tipo Descrição
card_id string Identificador único do cartão no sistema, usado para obter seus detalhes.

Parâmetros da resposta:

Parâmetro Tipo Descrição
status string Status de execução da solicitação (por exemplo, "success" para uma solicitação executada com sucesso).
code string Código de resposta (por exemplo, "REQUEST_SUCCESS" para uma solicitação bem-sucedida).
card_name string Nome do cartão especificado durante sua emissão.
card_number string Número do cartão emitido.
card_id string Identificador único do cartão no sistema.
cvv string Código de segurança do cartão necessário para autorização.
expiration_date string Data de validade do cartão no formato MM/YY.
password string Senha 3DS para segurança adicional durante transações online.
currency_code string Código da moeda usada para operações com o cartão.
currency_symbol string Símbolo da moeda (por exemplo: $ ou €).
time_created number Hora de criação do cartão no formato Unix timestamp.
date_created string Data de criação do cartão no formato YYYY-MM-DD.
date_renewal string Data da próxima cobrança pela renovação do cartão no formato YYYY-MM-DD.
time_renewal number Hora da próxima cobrança pela renovação do cartão no formato Unix timestamp.
email string Endereço de e-mail especificado durante a emissão do cartão.
phone_number string Número de telefone especificado durante a emissão do cartão.
address_line_1 string Endereço residencial especificado durante a emissão do cartão.
city string Cidade de residência especificada durante a emissão do cartão.
country_code string Código do país de acordo com o padrão ISO 3166-1 alpha-2 (por exemplo, "US" para os Estados Unidos).
first_name string Nome do proprietário do cartão.
last_name string Sobrenome do proprietário do cartão.
sur_name string Nome do meio do proprietário do cartão.
date_birth string Data de nascimento do proprietário do cartão no formato DD.MM.YYYY.
post_code string Código postal.
card_status string

Status do cartão.

Ativo: active

Bloqueado: blocked

Fechado: closed

Aguardando emissão: awaiting
balance number Saldo atual do cartão.
issuance_cost number Custo de emissão do cartão.
renewal_cost number Custo de renovação do cartão.
recharge_cost number Comissão de recarga do cartão.
recharge_type string Tipo de comissão de recarga do cartão (pode ser "fixed" para uma comissão fixa ou "percent" para uma comissão percentual). O valor da comissão é obtido do parâmetro recharge_cost.
account_refund_cost number Comissão de reembolso do cartão.
account_refund_type string Tipo de comissão de reembolso do cartão (pode ser "fixed" para uma comissão fixa ou "percent" para uma comissão percentual). O valor da comissão é obtido do parâmetro account_refund_cost.
refund_min_amount number Valor mínimo de reembolso do cartão.
min_recharge_amount number Valor mínimo de recarga do cartão.
max_recharge_amount number Valor máximo de recarga do cartão.
block_status string

Status de bloqueio do cartão.

Os valores possíveis podem ser encontrados na seção status de bloqueio do cartão.
date_blocked string Data de bloqueio do cartão no formato YYYY-MM-DD.
time_blocked number Hora de bloqueio do cartão no formato 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';
    }

?>

Renomear cartão

Este método da API permite alterar o nome de um cartão virtual no sistema Pay2.House.

Execute uma solicitação POST para o seguinte endereço:
Parâmetro Tipo Descrição
card_id string Identificador único do cartão no sistema, usado para obter seus detalhes.
name string Novo nome do cartão virtual. Comprimento máximo — 100 caracteres.

Parâmetros da resposta:

Parâmetro Tipo Descrição
status string Status de execução da solicitação (por exemplo, "success" para uma solicitação executada com sucesso).
code string Código de resposta (por exemplo, "REQUEST_SUCCESS" para uma solicitação bem-sucedida).
card_name string Nome do cartão virtual após a alteração.
<?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';
    }

?>

Recarga do cartão

Este método da API permite recarregar o saldo de um cartão virtual usando sua conta interna.

Os fundos serão creditados no cartão dentro de 2-3 minutos após a criação da solicitação de recarga.

Execute uma solicitação POST para o seguinte endereço:
Parâmetro Tipo Descrição
card_id string Identificador do cartão virtual que você deseja recarregar.
account_number string Número da sua conta interna da qual o valor da recarga será debitado.
amount number Valor que você deseja creditar no cartão virtual.

Parâmetros da resposta:

Parâmetro Tipo Descrição
status string Status de execução da solicitação (por exemplo, "success" para uma solicitação executada com sucesso).
code string Código de resposta (por exemplo, "REQUEST_SUCCESS" para uma solicitação bem-sucedida).
transaction_number string Número da transação associada à recarga do cartão.
<?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';
    }

?>

Reembolso do cartão

Este método da API permite iniciar um reembolso de um cartão virtual para sua conta interna.

Os fundos são devolvidos para a mesma conta da qual o cartão foi emitido.

Você receberá o valor menos a comissão de reembolso, de acordo com as tarifas do cartão.

Por exemplo, se você fizer um reembolso de $10 e a comissão de reembolso for 3%, então $10 × 3% = $0.30 serão retidos como comissão, e $9.70 serão creditados em sua conta.

Execute uma solicitação POST para o seguinte endereço:
Parâmetro Tipo Descrição
card_id string Identificador único do cartão do qual o reembolso é realizado.
amount number Valor do reembolso que deve ser transferido para a conta interna.

Parâmetros da resposta:

Parâmetro Tipo Descrição
status string Status de execução da solicitação (por exemplo, "success" para uma solicitação executada com sucesso).
code string Código de resposta (por exemplo, "REQUEST_SUCCESS" para uma solicitação bem-sucedida).
transaction_number string Número único da transação associada ao reembolso realizado do cartão.
<?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';
    }

?>

Histórico de operações do cartão

Este método da API fornece acesso à lista completa de operações realizadas com seu cartão virtual.

Execute uma solicitação POST para o seguinte endereço:
Parâmetro Tipo Descrição
card_id string Identificador único do cartão virtual para o qual você deseja obter o histórico de operações.
per_page number Quantidade de registros que serão exibidos em uma página.
page number Número da página para paginação.

Parâmetros da resposta:

Parâmetro Tipo Descrição
status string Status de execução da solicitação (por exemplo, "success" para uma solicitação executada com sucesso).
code string Código de resposta (por exemplo, "REQUEST_SUCCESS" para uma solicitação bem-sucedida).
count number Quantidade total de transações no histórico de operações deste cartão.
transactions array Lista de objetos contendo detalhes de cada transação, incluindo data, valor e tipo de operação.
<?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';
    }

?>

Atualizar saldo do cartão

Este método da API permite iniciar a atualização do saldo do cartão virtual, garantindo a obtenção de dados atualizados sobre o estado atual dos fundos no cartão.

Execute uma solicitação POST para o seguinte endereço:
Parâmetro Tipo Descrição
card_id string Identificador único do cartão virtual para o qual você deseja atualizar o saldo.

Parâmetros da resposta:

Parâmetro Tipo Descrição
status string Status de execução da solicitação (por exemplo, "success" para uma solicitação executada com sucesso).
code string Código de resposta (por exemplo, "REQUEST_SUCCESS" para uma solicitação bem-sucedida).
balance number Saldo atual do cartão virtual após a atualização, mostrando os fundos disponíveis.
<?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';
    }

?>

Códigos de confirmação do cartão

Este método da API permite obter uma lista de códigos de confirmação necessários para autorizar operações com o cartão virtual.

Execute uma solicitação POST para o seguinte endereço:
Parâmetro Tipo Descrição
card_id string Identificador único do cartão virtual para o qual são necessários códigos de confirmação de operações.

Parâmetros da resposta:

Parâmetro Tipo Descrição
status string Status de execução da solicitação (por exemplo, "success" para uma solicitação executada com sucesso).
code string Código de resposta (por exemplo, "REQUEST_SUCCESS" para uma solicitação bem-sucedida).
codes array Lista de códigos de confirmação necessários para concluir transações com o cartão.
<?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';
    }

?>

Bloquear cartão

Este método da API permite bloquear um cartão virtual, impedindo seu uso posterior.

Se houver fundos no saldo do cartão, eles serão devolvidos à conta interna da qual o cartão foi emitido, de acordo com as tarifas de reembolso.

No entanto, se o valor do reembolso após a dedução da comissão for menor que o valor mínimo de reembolso, esses fundos serão debitados do saldo do cartão.

Execute uma solicitação POST para o seguinte endereço:
Parâmetro Tipo Descrição
card_id string Identificador único do cartão virtual que você deseja bloquear.

Parâmetros da resposta:

Parâmetro Tipo Descrição
status string Status de execução da solicitação (por exemplo, "success" para uma solicitação executada com sucesso).
code string Código de resposta (por exemplo, "REQUEST_SUCCESS" para uma solicitação bem-sucedida).
<?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';
    }

?>

Fechar cartão

Este método da API permite fechar um cartão virtual, impedindo seu uso posterior.

É importante observar que este método não pode ser usado para fechar o cartão se ainda houver fundos nele.

Execute uma solicitação POST para o seguinte endereço:
Parâmetro Tipo Descrição
card_id string Identificador único do cartão virtual que você deseja fechar.

Parâmetros da resposta:

Parâmetro Tipo Descrição
status string Status de execução da solicitação (por exemplo, "success" para uma solicitação executada com sucesso).
code string Código de resposta (por exemplo, "REQUEST_SUCCESS" para uma solicitação bem-sucedida).
<?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';
    }

?>

Status de bloqueio do cartão

Descrição dos possíveis status de bloqueio do cartão e seus significados.

Status Descrição
terms_violation Violação dos termos de uso
insufficient_funds Fundos insuficientes
unauthorized_topup Tentativas de recarga não autorizadas
high_refund_rate Alta porcentagem de reembolsos
prebilling Primeiro faturamento
subscription_delay Atraso na taxa de assinatura
invalid_personal_data Dados pessoais incorretos ou incompletos
illegal_activity Tentativas de ações ilegais
verification_issues Problemas de verificação
high_risk Alto nível de risco
terms_change Alteração das condições do cartão
inactivity Inatividade
internal_errors Erros internos
regulatory_requirements Requisitos regulatórios
user_blocked Cliente bloqueou o cartão
not_blocked Não bloqueado

Webhook Events

Assim que o status do pagamento muda para "Pago", Pay2.House envia automaticamente notificações no formato webhook para o seu Webhook URL previamente especificado, que você configura para seu comerciante.

Enviaremos a notificação 100 vezes até recebermos o status HTTP 200 e o texto de resposta "OK".

Além disso, nosso sistema inclui automaticamente no cabeçalho da solicitação o parâmetro "Pay2-House-Signature" com um token único. Você pode usar esse token para verificar a autenticidade da solicitação.

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

Possíveis erros

Aqui estão alguns dos possíveis erros que podem ocorrer ao usar a API.

Código de erro Descrição do erro
INVALID_TOKEN Token de assinatura inválido ou ausente.
INVALID_API_KEY Chave API inválida ou ausente.
API_KEY_NOT_FOUND A chave API especificada não foi encontrada.
INACTIVE_API_KEY A chave API fornecida está inativa.
SIGNATURE_DECODING_FAILED Erro ao decodificar a assinatura.
INVALID_SIGNATURE_DATA Dados de assinatura inválidos.
EXPIRED_SIGNATURE A assinatura expirou.
MISMATCHED_SIGNATURE_ISSUER Key ID inválido ou ausente.
INVALID_MERCHANT_ID Merchant ID inválido ou ausente.
MERCHANT_ID_NOT_FOUND Merchant ID não encontrado.
ACCESS_DENIED_MERCHANT Acesso ao Merchant ID especificado negado.
INVALID_EXTERNAL_NUMBER Número externo do pagamento inválido ou ausente.
INVALID_AMOUNT Valor inválido.
INVALID_CURRENCY_CODE Código de moeda inválido.
INVALID_DESCRIPTION Descrição do pagamento inválida ou ausente.
SIGNATURE_VERIFICATION_FAILED A verificação da assinatura falhou devido a um erro.
INVALID_RETURN_URL URL de retorno após pagamento bem-sucedido inválido ou ausente.
INVALID_CANCEL_URL URL de cancelamento do pagamento inválido ou ausente.
INVALID_PAYER_EMAIL Endereço de e-mail do cliente inválido.
INVALID_COMMENT Comentário inválido ou ausente.
INSUFFICIENT_SENDER_BALANCE Saldo insuficiente na conta do remetente.
AMOUNT_EXCEEDS_SENDER_BALANCE O valor da transferência excede o saldo disponível na conta do remetente.
SENDER_ACCOUNT_NOT_FOUND Conta do remetente não encontrada.
INVALID_SENDER_ACCOUNT Conta do remetente inválida.
RECIPIENT_ACCOUNT_NOT_FOUND Conta do destinatário não encontrada.
INVALID_RECIPIENT_ACCOUNT Conta do destinatário inválida.
DIFFERENT_CURRENCY_CODES As contas do remetente e do destinatário têm moedas diferentes.
INVALID_TRANSFER As contas do remetente e do destinatário não podem ser iguais.
PROVIDER_NOT_FOUND Método de pagamento não encontrado ou inativo.
PROVIDER_OPTION_NOT_FOUND Opções do método de pagamento não encontradas.
AMOUNT_BELOW_MINIMUM O valor da transferência está abaixo do limite mínimo.
AMOUNT_EXCEEDS_MAXIMUM O valor da transferência excede o limite máximo.
INSUFFICIENT_BALANCE_AFTER_FEE Saldo insuficiente na conta do remetente após considerar a comissão.
INVALID_NAME_WALLET Nome da conta inválido ou ausente.
INVALID_PAYMENT_METHOD Método de pagamento inválido.
PAY2_HOUSE_NOT_ENABLED O método de pagamento Pay2.House não está disponível para seu comerciante.
USDT_TRC20_NOT_ENABLED O método de pagamento Tether USDT não está disponível para seu comerciante.
CARDS_NOT_ENABLED O método de pagamento CARDS não está disponível para seu comerciante.
TRON_ACCOUNT_CREATION_ERROR Erro ao criar conta TRON.
INVALID_INVOICE_NUMBER Formato do número da conta inválido.
INVOICE_NOT_FOUND Conta não encontrada.
MAX_WALLETS_REACHED Foi atingida a quantidade máxima permitida de contas para sua conta.
MERCHANT_NOT_APPROVED O comerciante não foi aprovado para processamento de pagamentos.
INVALID_DEADLINE_SECONDS Valor inválido do intervalo de tempo até a expiração do pagamento.
USER_DELETED O usuário foi excluído.
USER_BANNED O usuário está bloqueado.
USER_TEMPORARILY_BLOCKED O usuário está temporariamente bloqueado.
USER_NOT_FOUND Usuário não encontrado.
INVALID_PER_PAGE Valor inválido para o parâmetro "per_page". O valor deve estar entre 10 e 100.
INVALID_PAGE Valor inválido para o parâmetro "page". O valor deve ser um número inteiro positivo.
INVALID_STATUS Status inválido.
INSUFFICIENT_BALANCE Fundos insuficientes na conta para realizar esta operação.
INVALID_FIRST_NAME Nome informado incorretamente.
INVALID_LAST_NAME Sobrenome informado incorretamente.
INVALID_SUR_NAME Nome do meio informado incorretamente.
INVALID_ADDRESS Endereço residencial informado incorretamente.
INVALID_CITY Cidade de residência informada incorretamente.
INVALID_REGION Região de residência informada incorretamente.
INVALID_POST_CODE Código postal informado incorretamente.
INVALID_EMAIL E-mail informado incorretamente.
INVALID_DATE_BIRTH Data de nascimento informada incorretamente.
FORBIDDEN_COUNTRY O país não é permitido para uso.
INVALID_PHONE_NUMBER Número de telefone informado incorretamente.
INVALID_COUNTRY_CODE Código do país informado incorretamente.
VERIFICATION_REQUIRED É necessária verificação da conta para realizar a operação.
CARD_ISSUANCE_FAILED Não foi possível emitir o cartão.
INVALID_BIN_NUMBER Número BIN inválido ou ausente.
ACCOUNT_NOT_FOUND A conta especificada não foi encontrada.
INVALID_ACCOUNT_NUMBER Número da conta inválido ou ausente.
CARD_NOT_FOUND Cartão não encontrado.
CARD_BLOCKED Cartão bloqueado.
CARD_CLOSED Cartão fechado.
CARD_AWAITING Cartão em processo de emissão.
CARD_REFUND_FAILED Falha no reembolso do cartão.
CARD_BLOCKING_FAILED Falha no bloqueio do cartão devido a um erro interno do sistema.
CARD_DETAILS_FAILED Não foi possível obter os detalhes do cartão.
CARD_BALANCE_NOT_ZERO O cartão não pode ser fechado porque ainda há fundos nele.
CARD_CLOSING_FAILED Falha no fechamento do cartão devido a um erro interno do sistema.
REFUND_NOT_ALLOWED Reembolso não permitido.
CARD_HAS_NO_BALANCE O cartão não possui saldo.
CARD_REFUND_MIN_AMOUNT O valor mínimo de reembolso não foi atingido.
CARD_REFUND_MAX_AMOUNT O valor do reembolso excede o limite máximo.
CARD_REFUND_COST_GREATER O valor do reembolso após a dedução da comissão é menor que o mínimo permitido para reembolso.
CARD_REFUND_AMOUNT_ZERO O valor do reembolso deve ser maior que zero.
ACCOUNT_DELETED A conta especificada foi excluída.
CARD_MINIMUM_AMOUNT O valor da recarga deve ser maior que o valor mínimo.
CARD_MAXIMUM_AMOUNT O valor da recarga excede o valor máximo permitido.
CARD_BALANCE_REFRESH_FAILED Não foi possível atualizar o saldo do cartão.
CARD_HISTORY_REFRESH_FAILED Não foi possível atualizar o histórico de operações do cartão.
SENDER_ACCOUNT_DELETED A transferência de fundos não é possível porque a conta do remetente foi excluída ou desativada.
RECIPIENT_ACCOUNT_DELETED A transferência de fundos não é possível porque a conta do destinatário foi excluída ou desativada.
TRANSACTION_NOT_PROCESSED A transação não foi processada devido a um erro ou restrições internas.
TRANSACTION_NOT_FOUND Transação não encontrada no sistema.
INVALID_TRANSACTION_NUMBER Número da transação inválido ou ausente.
INVALID_DATE_RANGE Foi especificado um intervalo de datas incorreto. Verifique o formato e a lógica correta (a data inicial não pode ser maior que a data final).
Utilizamos cookies para melhorar o funcionamento do site. Ao continuar a utilizá-lo, aceita a nossa Política de Privacidade e os Termos de Utilização.