BANKON API PÚBLICA

Visão geral

Seja bem-vindo à documentação da BankOn! Aqui você encontrará as informações necessárias para fazer a integração com nossa infraestrutura.

Para utilização da API, é necessário obter um TOKEN de autenticação.

São fornecidos 2 (dois) tipos de Tokens:

Token de Consulta
Este token é utilizado exclusivamente para obter todas as consultas do tipo GET
Token de Transação
Este token é utilizado exclusivamente realizar transações financeiras.

Para criar e gerenciar seus tokens siga até o menu Usuário -> Tokens API.

Endpoint

Todas as respostas da API são em JSON e as requisições são feitas no endpoint:

  https://api.bankon.com.br/v1/

Toda chamada para a API tem, no retorno, o atributo sucesso e, em caso de erro , também virá o atributo erro, conforme os exemplos abaixo:

{
  "sucesso": true,
  "mensagem": "Mensagem de sucesso..."
}

{
  "sucesso": false,
  "mensagem": "Mensagem de erro..."
}

Dúvidas ou sugestões

Mande um e-mail para [email protected] em caso de dúvidas ou sugestões de melhorias e integrações da API.

Checkout Expresso

Se precisar efetuar uma cobranca rapida de seus clientes, utilize o checkout expresso. O usuário será enviado para o ambiente seguro da BankOn para efetuar a transação.

1. Crie uma solicitação de pagamento

A solicitação de pagamento contém todas as informações sobre o produto ou serviço a ser pago. Por exemplo:

Referencia do Pagamento
Valor
URLs de Callback de Sucesso e Falha

Solicitar Pagamentos

https://api.bankon.com.br/v1/checkout/solicita-pagamento

HEADERS

Authentication

required

string

{token_transacao}

Seu token para realizar Transações (sem as chaves)

Content-Type

required

string

application/json

BODY

email

required

string

Endereço de E-mail do usuário

valor

required

string

Valor do Pagamento

Exemplo: 100.58 = R$100,58;
Exemplo: 20 =R$20,00
Exemplo: 1000.48 =R$1.000,58

ref_pagamento

required

string

Descrição do Pagamento

Exemplo: ORDER ID X9995

url_callback_successo

required

string

URL de retorno em caso de sucesso

Exemplo: http://www.seudominio.com.br/url-sucesso

url_callback_falha

required

string

URL de retorno em caso de falha

Exemplo: http://www.seudominio.com.br/url-falha

    curl -X POST \
    https://api.bankon.com.br/v1/checkout/solicita-pagamento \
  -H 'Accept: */*' \
  -H 'Authentication:{token_transacao}' \
  -H 'Content-Type: application/json' \
   -d '{
	"email": "[email protected]",
	"ref_pagamento": "NOTEBOOK CORE 2 DUO",
	"valor": "18049.78",
	"url_callback_successo":"http://www.seudominio.com.br/url-sucesso",
	"url_callback_falha":"http://www.seudominio.com.br/url-falha"
}'

<?php

$data_string = json_encode(
      array(
        "email": "[email protected]",
        "ref_pagamento": "NOTEBOOK CORE 2 DUO",
        "valor": "18049.78",
        "url_callback_successo":"http://www.seudominio.com.br/url-sucesso",
        "url_callback_falha":"http://www.seudominio.com.br/url-falha"
	    )
    );

  
    $curl = curl_init();

    curl_setopt_array($curl, array(
      CURLOPT_URL => 'https://api.bankon.com.br/v1/checkout/solicita-pagamento',
      CURLOPT_RETURNTRANSFER => true,
      CURLOPT_ENCODING => "",
      CURLOPT_MAXREDIRS => 10,
      CURLOPT_TIMEOUT => 0,
      CURLOPT_FOLLOWLOCATION => false,
      CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
      CURLOPT_CUSTOMREQUEST => "POST",
      CURLOPT_POSTFIELDS => $data_string,
      CURLOPT_HTTPHEADER => array(
        "Content-Type: application/json",
        'Content-Length: ' . strlen( $data_string ),
        "Authentication: {token_transacao}"
      ),
    ));
    
    $response = curl_exec($curl);
    $err = curl_error($curl);
    
    curl_close($curl);
    
    if ($err) {
      echo "cURL Error #:" . $err;
    } else {
      echo $response;
    }
  ?>

Retorno JSON com sucesso

{
    "sucesso": true,
    "message": "Solicitação de pagamento registrada com sucesso.",
    "Dados": {
        "token_pagamento": "36C767C6-84B12BAE-248183EF-4E28A342",
        "url_pagamento": "https://api.bankon.com.br/checkout/p/36C767C6-84B12BAE-248183EF-4E28A342",
        "solicitacao": "2019-07-03 15:23:41",
        "expiracao": "2019-07-10 00:00:00"
    }
}

2. Leve seu comprador para check-out

Uma vez que a solicitação é criada, use o URL que você encontra no attribute url_pagamento da resposta para gerar um botão de pagamento:

<!DOCTYPE html>
<html>
    <head>
        <title>Pagar</title>
    </head>
    <body>
        <a href="<?php echo $dados->url_pagamento; ?>">Pagar</a>
    </body>
</html>

3. Retorno do Checkout

Após o pagamento ser efetuado pelo cliente, ele será redirecionado para a url_callback contendo o parâmero transacao na url:

http://www.seudominio.com.br/url_callback?transacao={codigo_transacao}

4. Validando a transação

Para garantir maior integridade e segurança, opcionalmente você poderá fazer a validação da transação seguindo os passos em Consulta Transferências.

PIX

A API Pix é o elemento final para que o usuário recebedor possa automatizar sua interação com a BankOn, a fim de receber e gerenciar transações Pix. O usuário recebedor poderá gerar QR Code de cobrança para pagamentos e verificar a liquidação desses pagamentos, entre outras possibilidades.

Listar cobranças PIX

https://api.bankon.com.br/v1/pix/cobrancas

HEADERS

Authentication

required

string

{token_consultas}

Seu token para realizar Consultas (sem as chaves)

Content-Type

required

string

application/json

PARAMETROS

initialDate

required

date

Data Inicial da Consulta

Formato: YYYY-mm-dd

Exemplo: 2019-01-25

finalDate

required

date

Data Final da Consulta

Formato: YYYY-mm-dd

Exemplo: 2019-01-30

status

optional

string

Tipo de transações a serem filtradas

PENDING - APPROVED - EXPIRED

Caso não informado serão retornados todos os tipos de movimentos

Request

cURL
PHP

ccurl --location --request GET 'https://api.bankon.com.br/v1/pix/cobrancas?initialDate=2021-04-01&finalDate=2021-04-30&status=APPROVED' \
--header 'Authentication: {token_consultas}' \
--header 'Content-Type: application/json' \
--header 'Cookie: PHPSESSID=f9sv7g0sd64gtvvua18bb6njqg'

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://api.bankon.com.br/v1/pix/cobrancas?initialDate=2021-04-01&finalDate=2021-04-30&status=APPROVED',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'GET',
  CURLOPT_HTTPHEADER => array(
    'Authentication: {token_consultas}',
    'Content-Type: application/json'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;
  ?>

Retorno JSON com sucesso

{
    "sucesso": true,
    "message": "sucesso",
    "rows": [
      {
            "transactionId": "6F9B893BD6350934",
            "dateCreated": "2021-04-20 15:24:09",
            "amount": "1.50",
            "status": "APPROVED",
            "payerName": "Roronoa Zoro",
            "dateApproval": "2021-04-20 17:29:26"
        },
        {
            "transactionId": "A54DF363D6990937",
            "dateCreated": "2021-04-20 17:22:33",
            "amount": "1.20",
            "status": "APPROVED",
            "payerName": "Monkey D. Luffy",
            "dateApproval": "2021-04-20 17:29:26"
        },
        {
            ...
        }
    ]
}

BODY RESPONSE

transactionId	ID único da transação
dateCreated	Data da criação da cobrança
amount	Valor da cobrança
status	Status da transação
payerName	Nome original do pagador informado
dateApproval	Data do pagamento

Consultar uma cobranca PIX

https://api.bankon.com.br/v1/pix/cobrancas/:transactionId

HEADERS

Authentication

required

string

{token_consultas}

Seu token para realizar Consultas (sem as chaves)

Content-Type

required

string

application/json

PARAMETROS

transactionId

required

string

ID único da transação

Request

cURL
PHP

ccurl --location --request GET 'https://api.bankon.com.br/v1/pix/cobrancas/6F9B893BD6350934' \
--header 'Authentication: {token_consultas}' \
--header 'Content-Type: application/json'

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://api.bankon.com.br/v1/pix/cobrancas/6F9B893BD6350934',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'GET',
  CURLOPT_HTTPHEADER => array(
    'Authentication: {token_consultas}',
    'Content-Type: application/json'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

  ?>

Retorno JSON com sucesso

{
    "sucesso": true,
    "message": "Transação encontrada",
    "body": {
        "transactionId": "818DA0CCE8E112F7",
        "status": "APPROVED",
        "originalValue": "1.50",
        "amountPaid": "1.50",
        "payerName": "Roronoa Zoro",
        "additionalInformation": {
          "value": "LOJA XYZ - PRODUTO ABC"
        },
        "creditParty": {
            "name": "RORONOA ZORO",
            "taxId": "99988877766"
        },
        "debitParty": {
          "name": "Monkey D. Luffy",
            "taxId": "99988877766",
            "bank": "NU PAGAMENTOS S.A.",
            "branch": "1",
            "account": "860599601"
        },
        "emvqrcps": null,
        "base64image": null,
        "transactionIdentification": "kk6g232xel65a0daee4dd13kk553479959",
        "authentication": "E18236120202104220033s01591135PO"
    }
}

BODY RESPONSE

transactionId	ID único da transação
dateCreated	Data da criação da cobrança
originalValue	Valor da cobrança
amountPaid	Valor Pago
payerName	Nome original do pagador informado
status	Status da transação
creditParty->name	Nome do beneficiario na BankOn
creditParty->taxId	CPF/CNPJ do beneficiario na BankOn
debtor->name	Nome do pagador
debtor->cpf	CPF pagador (Caso Pessoa Física)
debtor->cpj	CPNJ pagador (Caso Pessoa Jurifica)
emvqrcps	EMV do QRCode
base64image	Imagem em base64
transactionIdentification	Código único de identificação do Pagamento
authentication	Código do pagamento Ponta-a-Ponta no DICT

Criar uma cobrança PIX

https://api.bankon.com.br/v1/pix/qrcode

HEADERS

Authentication

required

string

{token_transacao}

Seu token para realizar Transações (sem as chaves)

Content-Type

required

string

application/json

BODY REQUEST

valor required float(10.2)	Valor da cobrança Exemplo: 100.58 = R$100,58
identificacao required string(100)	Identificação da cobrança Exemplo: LOJA XYZ - PRODUTO ABC
nomePagador required string(100)	Nome do pagador Exemplo: Roronoa Zoro
documentoPagador required string(15)	CPF ou CNPJ do pagador: Exemplo: 99988877732
urlNotificacao required string(200)	URl para notificação Exemplo: http://webhook.seudominio.com.br/

Request

cURL
PHP

curl --location --request POST 'https://api.bankon.com.br/v1/pix/qrcode' \
--header 'Authentication: {token_transacao}-0a9311b8' \
--header 'Content-Type: application/json' \
--data-raw '{
    "valor": 1.50,
    "identificacao": "LOJA XYZ - PRODUTO ABC",
    "nomePagador":"Roronoa Zoro",
    "documentoPagador":"99999999999",
    "urlNotificacao": "http://url-webhook-pagamento/"
}'

<?php

$data_string = json_encode(
      array(
            "valor"=> 1.50,
            "identificacao"=> "LOJA XYZ - PRODUTO ABC",
            "nomePagador"=>"Roronoa Zoro",
            "documentoPagador"=>"99999999999",
            "urlNotificacao"=> "http://url-webhook-pagamento/"
	       )
      );

$curl = curl_init();


curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://api.bankon.com.br/v1//pix/qrcode',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS => $data_string,
  CURLOPT_HTTPHEADER => array(
    'Authentication: '.{token_transacao},
    'Content-Type: application/json'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;
  ?>

Retorno JSON com sucesso

{
    "sucesso": true,
    "message": "Cobrança gerada com sucesso",
    "status": 201,
    "body": {
        "transactionId": "D42FDD03D7A60945",
        "entity": "PixImmediateCollection",
        "status": "ACTIVE",
        "amount": "1.50",
        "calendar": {
            "expiration": 432000,
            "dueDate": "2021-04-27 17:02:59"
        },
        "debtor": {
            "name": "Roronoa Zoro",
            "document": "99999999999"
        },
        "additionalInformation": {
            "value": "LOJA XYZ - PRODUTO ABC"
        },
        "emvqrcps": "00020101021226930014br.gov.bcb.pix...",
        "base64image": "iVBORw0KGgoAAAANSUhEUgAABbQAAAW0CAYAAAAeooXXAAAABGdGwAAA..."
    }
}

BODY RESPONSE

body->transactionId	ID único da transação
body->status	Status da transação
body->amount	Valor da cobrança
body->calendar->expiration	Indicador de tempo para expiração do QRCode
body->calendar->dueDate	Data de vencimento do QR Code
body->debtor->name	Nome do pagador
body->debtor->document	Documento do pagador
body->additionalInformation->value	Identificação da cobrança
body->emvqrcps	EMV do QRCode, a representação dos dados criptografada. Utilizada quando não se pode ler o QRCode (Copia e cola)
body->base64image	Imagem em base64

Webhook do pagamento

Todos os eventos são enviados através de uma requisição HTTP/HTTPS POST com o formato JSON no payload.

Seu endpoint informado na Criação de uma cobrança (item urlNotificacao ) precisa retornar um status code de sucesso na resposta, sendo (2xx) um formato válido, assim consideraremos como entregue. Caso contrário, vamos retentar entregar a notificação mais 4 vezes, com intervalo de 1 minuto cada, depois disso, não vamos mais tentar entregar a notificação deste evento.

O exemplo abaixo é um exemplo de um payload de evento que enviamos.

1. Exemplo de Payload de uma confirmação de recebimento

{
    "requestBody": {
        "transactionType": "RECEIVEPIX",
        "transactionId": "0424ADBC8402150B",
        "amount": 1.04,
        "dateApproval": "2021-04-01 06:24:25",
        "payerName": "Roronoa Zoro",
        "creditParty": {
            "userId": "luffy",
            "email": "[email protected]",
            "taxId": "99988877732",
            "name": "Monkey D. Luffy"
        },
        "debitParty": {
            "account": "860599601",
            "bank": "NU PAGAMENTOS S.A.",
            "branch": "1",
            "taxId": "90459180134",
            "name": "Naruto Jose"
        },
        "authentication": "E18236120202104220033s01591135PO"
    }
}

Esta requisição deve ser respondida apenas com um HTTP status 200.

2. Exemplo de Payload de uma expiração de um QRCode

{
    "requestBody": {
        "transactionType": "EXPIRED",
        "transactionId": "D42FDD03D7A60945"
    }
}

Esta requisição deve ser respondida apenas com um HTTP status 200.

Financeiro

Utilize estes endpoints para consultar detalhes de sua conta.

Consultar extrato

https://api.bankon.com.br/v1/consultas/extrato

Consulta o extrato do Cliente

HEADERS

Content-Type

required

string

application/json

Authentication

required

string

{token_consultas}

Seu token de acesso a API (sem as chaves)

PARAMETROS

initialDate

required

date

Data Inicial da Consulta

Formato: YYYY-mm-dd

Exemplo: 2019-01-25

finalDate

required

date

Data Final da Consulta

Formato: YYYY-mm-dd

Exemplo: 2019-01-30

type

optional

string

Tipo de transações a serem filtradas

C - Crédito D - Débito

Caso não informado serão retornados todos os tipos de movimentos

Request

cURL
PHP

curl --location --request GET "https://api.bankon.com.br/v1/consultas/extrato?initialDate=2019-03-17&finalDate=2019-04-10" \
  --header "Content-Type: application/json" \
  --header "Authentication: {token_consultas}"'

<?php
  $curl = curl_init();
  curl_setopt_array($curl, array(    
    CURLOPT_URL => "https://api.bankon.com.br/v1/consultas/extrato?initialDate=2019-03-17&finalDate=2019-04-10",    
    CURLOPT_RETURNTRANSFER => true,    
    CURLOPT_ENCODING => "",    
    CURLOPT_MAXREDIRS => 10,    
    CURLOPT_TIMEOUT => 0,    
    CURLOPT_FOLLOWLOCATION => false,    
    CURLOPT_HTTP_VERSION => 
    CURL_HTTP_VERSION_1_1,    
    CURLOPT_CUSTOMREQUEST => "GET",    
    CURLOPT_HTTPHEADER => array(      
      "Content-Type: application/json",      
      "Authentication: {token_consultas}"    
      ),  
  ));    
  $response = curl_exec($curl);  
  $err = curl_error($curl);    
  curl_close($curl);    
  if ($err) {    
    echo "cURL Error #:" . $err;  
  } else {    
    echo $response;  
  } 
  ?>

Retorno JSON com sucesso

{
  "sucesso":true,
  "message":"Extrato consultado com sucesso.",
  "resultados":[
    {
      "data":"2019-04-08 23:26:50",
      "transacao":"5f10460e853f98yss",
      "tipo":"D",
      "valor":"-50.00",
      "historico":"Tranferência Enviada para Fulano de Tal"
    },
      {
        "data":"2019-04-08 23:22:54",
        "transacao":"5f10460e853f98yss",
        "tipo":"C","valor":"100.00",
        "historico":"Depósito via Transferência"
      }
        ]
      }

Nova Transferência

https://api.bankon.com.br/v1/financeiro/transferencia

Endpoint de transferências entre usuários

Por questões se segurança, todas as transferências efetuadas via API ficam pendentes de aprovação pelo titular da conta. Posteriormente as mesmas devem ser aprovadas no menu Transferências->Transferências pendentes.

HEADERS

Content-Type

required

string

application/json

Authentication

required

string (200)

{token_transacao}

Seu token para realizar Transações (sem as chaves)

BODY

beneficiario

required

string

usuario que receberá a transferência

valor

required

FLOAT

Valor da transferência

Exemplo: 100.58 = R$100,58;
Exemplo: 20 =R$20,00

id_transferencia

required

string

Identificação única da transferência

Exemplo: X9995

Request

cURL
PHP

curl --location --request POST "https://api.bankon.com.br/v1/financeiro/transferencia" \
--header "Content-Type: application/json" \
--header "Authentication:  {token_transacao}" \
--data "{
\"beneficiario\": \"fulano\",
\"valor\": \"1000.00\",
\"id_transferencia\": \"X9995\"
}"

<?php

$data_string = json_encode(
      array(
        'beneficiario' => 'fulano' ,
        'valor' => '1000.00',
        'id_transferencia' => 'X9995'
	    )
    );

  
    $curl = curl_init();

    curl_setopt_array($curl, array(
      CURLOPT_URL => 'https://api.bankon.com.br/v1/financeiro/transferencia',
      CURLOPT_RETURNTRANSFER => true,
      CURLOPT_ENCODING => "",
      CURLOPT_MAXREDIRS => 10,
      CURLOPT_TIMEOUT => 0,
      CURLOPT_FOLLOWLOCATION => false,
      CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
      CURLOPT_CUSTOMREQUEST => "POST",
      CURLOPT_POSTFIELDS => $data_string,
      CURLOPT_HTTPHEADER => array(
        "Content-Type: application/json",
        'Content-Length: ' . strlen( $data_string ),
        "Authentication: {token_transacao}"
      ),
    ));
    
    $response = curl_exec($curl);
    $err = curl_error($curl);
    
    curl_close($curl);
    
    if ($err) {
      echo "cURL Error #:" . $err;
    } else {
      echo $response;
    }
  ?>

Retorno JSON com sucesso

{
	"sucesso": true,
	"message": "Transferênca pendente de aprovação",
	"dados": {
		"transacao": "c4bb726884db0735",
		"favorecido": "Fulano de tal",
		"favorecido_user": "fulano",
		"data": "03/05/2019",
		"hora": "17:33",
		"valor": "1000,00",
    "status": "pendente"
	}
}

Consultar saldo

https://api.bankon.com.br/v1/consultas/saldo

Verifica o saldo disponível no sistema

HEADERS

Content-Type

required

string

application/json

Authentication

required

string

{token_consultas}

Seu token de acesso a API (sem as chaves)

Request

cURL
PHP

curl --location --request GET "https://api.bankon.com.br/v1/consultas/saldo" \
  --header "Content-Type: application/json" \
  --header "Authentication: {token_consultas}"'

<?php
  $curl = curl_init();
  curl_setopt_array($curl, array(    
    CURLOPT_URL => "https://api.bankon.com.br/v1/consultas/saldo",    
    CURLOPT_RETURNTRANSFER => true,    
    CURLOPT_ENCODING => "",    
    CURLOPT_MAXREDIRS => 10,    
    CURLOPT_TIMEOUT => 0,    
    CURLOPT_FOLLOWLOCATION => false,    
    CURLOPT_HTTP_VERSION => 
    CURL_HTTP_VERSION_1_1,    
    CURLOPT_CUSTOMREQUEST => "GET",    
    CURLOPT_HTTPHEADER => array(      
      "Content-Type: application/json",      
      "Authentication: {token_consultas}"    
      ),  
  ));    
  $response = curl_exec($curl);  
  $err = curl_error($curl);    
  curl_close($curl);    
  if ($err) {    
    echo "cURL Error #:" . $err;  
  } else {    
    echo $response;  
  } 
  ?>

Retorno JSON com sucesso

{
    "sucesso":true,
    "message":"Consulta realizada com sucesso.",
    "Dados":{
        "usuario":"fulano",
        "saldo_disponivel":"166.76"
    }
}

Consultar Transferências

https://api.bankon.com.br/v1/consultas/transferencias/{codigo_transacao}

Consulta uma transação entre contas Bankon

PARAMETROS

Authentication

required

string

{token_consultas}

Seu token de acesso a API (sem as chaves)

codigo_transacao

required

string

O número da transação

Request

cURL
PHP

curl --location --request GET 'https://api.bankon.com.br/v1/consultas/transferencias/5f10460e8539073a' \
--header "Content-Type: application/json" \
--header "Authentication: {token_consultas}"'

<?php

  $curl = curl_init();
  
  curl_setopt_array($curl, array(
  CURLOPT_URL => "https://api.bankon.com.br/v1/consultas/transferencias/5f10460e8539073a",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => false,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => array(
  "Content-Type: application/json",
  "Authentication: {token_consultas}"
  ),
  ));
  
  $response = curl_exec($curl);
  $err = curl_error($curl);
  
  curl_close($curl);
  
  if ($err) {
  echo "cURL Error #:" . $err;
  } else {
  echo $response;
} 
 
?>

Retorno JSON com sucesso

{
  "sucesso":true,
  "message":"Consulta realizada com sucesso.",
  "Dados":{
    "data":"2019-04-08 23:26:50",
    "valor":"50.00",
    "status": "transferido",
    "origem":{"usuario":"fulanodetal",
      "nome":"Fulano de Tal",
      "documento":"*********06"},
      "destino":{
        "usuario":"beltrano",
        "nome":"Beltrano Ciclano",
        "documento":"*********08"
      }
    }
  }

Consultar Usuários

  https://api.bankon.com.br/v1/consultas/usuario/{usuario}

HEADERS

Content-Type

required

string

application/json

Authentication

required

string

{token_consultas}

Seu token de acesso a API (sem as chaves)

PARAMETROS

usuario

required

string

O Usuário ao qual deseja realizar consulta

Request

cURL
PHP

curl --location --request GET "https://api.bankon.com.br/v1/consultas/usuario/fulanodetal" \
  --header "Content-Type: application/json" \
  --header "Authentication: {token_consultas}"'

<?php
  $curl = curl_init();
  curl_setopt_array($curl, array(    
    CURLOPT_URL => "https://api.bankon.com.br/v1/consultas/usuario/fulanodetal",    
    CURLOPT_RETURNTRANSFER => true,    
    CURLOPT_ENCODING => "",    
    CURLOPT_MAXREDIRS => 10,    
    CURLOPT_TIMEOUT => 0,    
    CURLOPT_FOLLOWLOCATION => false,    
    CURLOPT_HTTP_VERSION => 
    CURL_HTTP_VERSION_1_1,    
    CURLOPT_CUSTOMREQUEST => "GET",    
    CURLOPT_HTTPHEADER => array(      
      "Content-Type: application/json",      
      "Authentication: {token_consultas}"    
      ),  
  ));    
  $response = curl_exec($curl);  
  $err = curl_error($curl);    
  curl_close($curl);    
  if ($err) {    
    echo "cURL Error #:" . $err;  
  } else {    
    echo $response;  
  } 
  ?>

Retorno JSON com sucesso

{
  "sucesso":"true",
  "message":"Usuário consultado com sucesso.",
  "Dados":{
    "documento":"*********06",
    "nome":"Fulano de tal",
    "usuario":"funano",
    "email":"[email protected]",
    "localidade":{
      "cidade":"Cidade",
      "estado":"UF"
    }
  }
}