BconGlobal
BconGlobal
Login

API документація

Ми не обслуговуємо клієнтів з Росії. Якщо ваш бізнес знаходиться в Росії або ваш сервер має російську IP-адресу, весь трафік до нашого API буде автоматично заблоковано.

Api ключ

Щоб згенерувати ключ API, створіть "Магазин" у панелі Bcon, а потім перейдіть до розділу «Налаштування магазину» > «Копіювати згенеровані ключі» ( Для кожного блокчейну свій ключ ). Щоб використовувати ключ API, передайте його в заголовку запиту:

Authorization: Bearer <apikey>

Balance

Повертає баланс (на сервісі) авторизованого користувача для заданих адрес. Адреси можна перераховувати, розділяючи пробілами. Запит вимагає використання ключа API у заголовку Authorization: Bearer <ключ API>.

Ця опція тільки BTC.

Визначення 

GET https://external-api.bcon.global/api/v1/user/balance?address=<Whitespace separated list of wallets addresses>

Приклад запиту 

curl -H 'Authorization: Bearer 018TmI5IzJPzl3x1uCMZJvii63c8SV9vHMDA' 'https://external-api.bcon.global/api/v1/user/balance?address=1dice8EMZmqKvrGE4Qc9bUFf9PX3xaYDp 1dice97ECuByXAvqXpaYzSaQuPVvrtmz6'

Приклад запиту

{"status":"Ok","data":{"wallets":[{"id":5197,"address":"bc1qrr3g9kswpfhkmwa6s35rgzgv8a6pjhsmjt43hk","balance":"-0.000000715200000000","balance_bonus":"0.000000000000000000","currency":{"id":1,"name":"BTC","iso_name":"btc"},"created_at":"2023-05-25T06:11:12.000000Z"}]}}

PHP код

<?php
$curl = curl_init();
curl_setopt_array($curl, 
array(  CURLOPT_URL => 'https://external-api.bcon.global/api/v1/user/balance?address=1dice97ECuByXAvqXpaYzSaQuPVvrtmz6',
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(    'Accept: application/json',
'Content-Type: application/json',
'Authorization: Bearer 018TmI5IzJPzl3x1uCMZJvii63c8SV9vHMDA'  ),));

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

Java script код

Стандартний Node.js HTTP(S) модуль

const https = require('https');

const options = {
hostname: 'external-api.bcon.global',
port: 443,
path: '/api/v1/user/balance?address=1dice97ECuByXAvqXpaYzSaQuPVvrtmz6',
method: 'GET',
headers: {    'Accept': 'application/json',
'Content-Type': 'application/json',
'Authorization': 'Bearer 018TmI5IzJPzl3x1uCMZJvii63c8SV9vHMDA'
 }
};

const req = https.request(options, res => {  
let data = '';

res.on('data', chunk => {    
data += chunk;  
});

res.on('end', () => {    
console.log(JSON.parse(data));  
 });
});

req.on('error', error => {  
console.error('Error:', error);
});

req.end();

Axios library

const axios = require('axios');
axios.get('https://external-api.bcon.global/api/v1/user/balance', {
params: {        
          address: '1dice97ECuByXAvqXpaYzSaQuPVvrtmz6'    
        },
headers: {    
          'Accept': 'application/json',
          'Content-Type': 'application/json',
          'Authorization': 'Bearer 018TmI5IzJPzl3x1uCMZJvii63c8SV9vHMDA'    
 }
})
.then(response => {    
                    console.log(response.data);
})

.catch(error => {    
                    console.error('Error:', error);
});

Request library

const request = require('request');

request('https://external-api.bcon.global/api/v1/user/balance?address=1dice97ECuByXAvqXpaYzSaQuPVvrtmz6', {  
     headers: {    
                'Authorization': 'Bearer 018TmI5IzJPzl3x1uCMZJvii63c8SV9vHMDA'  
 }
}, (error, response, body) => {  
if (error) {    
console.error('Error:', error);  
} else {    
console.log('Response:', body);  
 }
});

History

Повертає історію транзакцій кількох біткоїн-адрес/XPUB, вважаючи їх частиною одного гаманця. Транзакції відсортовані від нових до старих.

Визначення 

GET https://external-api.bcon.global/api/v1/user/history?address=<Whitespace separated list of wallets addresses>

Приклад запиту

curl -H 'Authorization: Bearer 018TmI5IzJPzl3x1uCMZJvii63c8SV9vHMDA' 'https://external-api.bcon.global/api/v1/user/history?address=1dice8EMZmqKvrGE4Qc9bUFf9PX3xaYDp 1dice97ECuByXAvqXpaYzSaQuPVvrtmz6'

Приклад запиту

{"status":"Ok","data":{"transactions":[{"transaction_id":"0xb46a64ce38730f20a39e9825274f4d253dca9a78879b2ad224def96851da343f","status":"confirmed","preset":"oc-test","tag":"oc-test","currency":{"id":3,"name":"BNB","iso_name":"bnb"},"sum":"0.004437730000000000","created_at":"2023-06-12T07:32:23.000000Z"},{"transaction_id":"0xd553be50ca700ea95d70eae8d669a8f6da50ecdd670e8aa61244e2ce2c6acdcd","status":"confirmed","preset":"oc-test","tag":"oc-test","currency":{"id":3,"name":"BNB","iso_name":"bnb"},"sum":"0.004433600000000000","created_at":"2023-06-12T06:58:25.000000Z"},{"transaction_id":"0x20a28f830a1e056f12ebb515a7fd897134c353f99be0f207cb1e53212cd8d2a4","status":"confirmed","preset":"oc-test","tag":"oc-test","currency":{"id":3,"name":"BNB","iso_name":"bnb"},"sum":"0.004433600000000000","created_at":"2023-06-12T06:50:54.000000Z"},{"transaction_id":"0x460df82df7e3a199fa4b752d4ee5c95aff0fb1f456eb1b149587e3465f92353f","status":"confirmed","preset":null,"tag":null,"currency":{"id":3,"name":"BNB","iso_name":"bnb"},"sum":"0.010496960000000000","created_at":"2023-05-25T06:23:25.000000Z"}],"meta":{"total":4,"currentPage":1,"currentPageTotal":4,"lastPage":1,"perPage":10}}}

Де :

  • Transaction_id - номер транзакції в блокчейні;
  • Status - статус транзакції: не підтверджена, частково підтверджена, остаточно підтверджена ( 2 підтвердження );
  • Preset - ім'я в системі ( Назва вашого магазину в панелі Bcon );
  • Tag - tag oвашого магазину в панелі Bcon;
  • Currency - валюта ( BTC,ETH,BNB,USDT,SOL,USDC або інша );
  • Created_at - дата створення транзакції;
  • Meta - пагінація для отримання наступних транзакцій.

PHP код

<?php
$curl = curl_init();

curl_setopt_array($curl, array(  
CURLOPT_URL => 'https://external-api.bcon.global/api/v1/user/history?address=1dice8EMZmqKvrGE4Qc9bUFf9PX3xaYDp 1dice97ECuByXAvqXpaYzSaQuPVvrtmz6',  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(    'Accept: application/json',    
'Content-Type: application/json',    
'Authorization: Bearer xFk3K3xnUrU23wX37c1HyoF2g2LDGdSzpZKDxDSQ'  ),
));

$response = curl_exec($curl);

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

Transaction Details

Повертає деталі транзакції по TxID

Визначення 

GET https://external-api.bcon.global/api/v1/transactions/<txid>

Приклад запиту

curl -H 'Authorization: Bearer 018TmI5IzJPzl3x1uCMZJvii63c8SV9vHMDA' 'https://external-api.bcon.global/api/v1/transactions/c4978bfc9b4cd632fb37eb5f69e72530a4e'

Приклад запиту

{"status":"Ok","data":{"transaction":{"id":25383,"transaction_id":"0xb46a64ce38730f20a39e9825274f4d253dca9a78879b2ad224def96851da343f","address":"0xB94522D6d928361111c4956E7ed8A48f0aB9969C","status":"confirmed","sum":"0.004437730000000000","log_line":"https://bcon.global/index.php?addr=0x6dE751cfeb935E90c8bdED1F67E1250F8912f114&status=2&txid=0xb46a64ce38730f20a39e9825274f4d253dca9a78879b2ad224def96851da343f&memo=1203481157&value=0.00443773&route=extension%2Fpayment%2Fcprocessing%2Fcallback&amp%3Bsecret=3ad71073d7e2d3cc261bc88ef5e86f74","store":{"id":212,"xpub":null,"name":"oc-test","name_bnb":null,"tag":"oc-test","tag_bnb":null,"api_key_bnb":"8zuSZ5AFJPscrWBaiZey1kivsejxT2YcqH2h9EgS","callback_url_bnb":"https://bcon.global/index.php?route=extension/payment/cprocessing/callback&secret=05cee5d9d07e0f0e7ada6a7dc07aa0fb","addresses":[{"id":37057,"address":"8913036001","created_at":"2023-06-12T06:48:38.000000Z"},{"id":37058,"address":"5720289312","created_at":"2023-06-12T06:56:39.000000Z"},{"id":37059,"address":"1203481157","created_at":"2023-06-12T07:30:37.000000Z"}],"created_at":"2023-06-12T06:48:16.000000Z"},"currency":{"id":3,"name":"BNB","iso_name":"bnb"},"created_at":"2023-06-12T07:32:23.000000Z"}}}
  • Id - внутрішній номер в системі Bcon;
  • Transaction_id - ID транзакції в блокчейні;
  • Address - адреса надходження;
  • Status - статус транзакції: не підтверджена, частково підтверджена, остаточно підтверджена ( 2 підтвердження );
  • Sum - сумма в токенах;
  • Log_line - url адресу callback;
  • Store - інформація по магазину який отримав транзакції;
  • Currency - валюта ( BTC,ETH,BNB,USDT,SOL,USDC або інша );
  • Date - дата & час транзакції.

Store list

Отримання списку магазинів авторизованого користувача

GET https://external-api.bcon.global/api/v1/stores/

Приклад запиту

curl -H 'Authorization: Bearer 2cDNOlCN985d7Rx3atSDOlmMeYaxzho2uPmHheIw4eU' 'https://external-api.bcon.global/api/v1/stores'

Приклад запиту

{"status":"Ok","data":{"addresses":[{"id":212,"xpub":null,"binance_address":"0x6dE751cfeb935E90c8bdED1F67E1250F8912f114","name":"oc-test","name_bnb":null,"tag":"oc-test","tag_bnb":null,"api_key":"nJAXAdDWkdRN4PqRFYvTM6kkbZ","api_key_bnb":"8zuSZ5AFJPscrWBaiZ","callback_url":null,"callback_url_bnb":"https://bcon.global/index.php?route=extension/payment/cprocessing/callback&secret=05cee5d9d07e0f0e7ada","created_at":"2023-06-12T06:48:16.000000Z"},{"id":215,"xpub":null,"binance_address":"0x6dE751cfeb935E90c8bdED1F67E1250F8912f114","name":"0x6dE751cfeb935E90c8","name_bnb":null,"tag":"0x6dE751cfeb935E90c8","tag_bnb":null,"api_key":"lFcsUs3BfkT4tCyhSgyOl4CHpkdpCCbWX5hm6uWK","api_key_bnb":"hh8KyzjYTDBIzJ5gWiNb0AWredHz9DXrczwlqMd5","callback_url":null,"callback_url_bnb":"https://bcon.global/?wc-api=WC_Gateway_Cprocessing&secret=c06fcf59ced091fc4625b5","created_at":"2023-06-14T12:17:17.000000Z"},{"id":216,"xpub":"zpub6o1ZT7MMTN9aoskeENCnZZYKfaYZFa6mDx5ubpLTuz5t7bCTryj1K8MkWpksrSYHTeaUuv1GGcXkLim","binance_address":null,"name":"oc-new-test","name_bnb":null,"tag":"oc-new-test","tag_bnb":null,"api_key":"fwrecxVpsmxVk7TqTWHLvSG4pxLxKYQSWyC1Uq0H","api_key_bnb":"pQa9EvOqooUUDvEtSItZUZCQDT8bisEufqrYrXd5","callback_url":"https://bcon.global/index.php?route=extension/payment/cprocessing/callback&amp;secret=05cee5d9d07e0f0","callback_url_bnb":null,"created_at":"2023-06-15T11:09:44.000000Z"},{"id":217,"xpub":"zpub6o1ZT7MMTN9aoskeENCnZZYKfaYZFa6mDx5ubpLTuz5t7bCTryj1K8MkWpksrSYHTeaUv","binance_address":null,"name":"wp-new-test","name_bnb":null,"tag":"wp-new-test","tag_bnb":null,"api_key":"5kmK1jFmSG5MbqTotEdaOzv2VfBEd","api_key_bnb":"DiXZ80xsagoHwasL7aPRTyEz1ekRykaZ","callback_url":"https://bcon.global/?wc-api=WC_Gateway_Cprocessing&secret=ee83e986361f02193e23a0fcccd6849ad4f6a21c","callback_url_bnb":null,"created_at":"2023-06-15T11:13:28.000000Z"}]}}
  • Id - Внутрішній номер в системі Bcon;
  • Xpub - xpub для BTC, якщо вказаний;
  • Name - Назва магазину в Bcon;
  • Tag - tag магазину в Bcon;
  • Api_key - btc api key ;
  • Api_key_bnb - bnb api key;
  • Api_key_для кожного з налаштованих блокчейнів;
  • Callback_url - адреса Callback BTC;
  • Callback_url_bnb -адреса Callback BNB;
  • Callback_url_ для кожного з налаштованих блокчейнів;
  • Created_at - Дата створення магазину;

New Address

Не розумієте як це працює? Читайте в нашій статті ( Англійською ): How to start accepting crypto payments with the Bcon "New address" API function

Цей endpoint призначений для створення нової адреси для відстеження. Повертає адресу гаманця, який прийматиме платежі. Щоб отримати вже існуючу останню адресу, передайте значення 1 у параметрі reset запиту: ?reset=1. Можна використовувати для тестування.

Визначення

POST https://external-api.bcon.global/api/v2/address
POST https://external-api.bcon.global/api/v2/address?reset=1

Приклад запиту

curl -d '' -H 'Authorization: Bearer 2cDNOlCN985d7Rx3atSDOlmMeYaxzho2uPmHheIw4eU' https://external-api.bcon.global/api/v2/address
curl -d '' -H 'Authorization: Bearer 2cDNOlCN985d7Rx3atSDOlmMeYaxzho2uPmHheIw4eU' https://external-api.bcon.global/api/v2/address?reset=1

Приклад запиту

ETH - {"status":"Ok","data":{"message":"Address successfully 
created","address":"0x72E4CF05e4A6b123623B7443fBF8C83BD14182f1","payment_amount":"15.00403608","payment_currency":"usdc"}}

( Опис параметрів Callback ) :

Address - Адреса на яку очікується оплата.

Payment_amount ( callback ) - Очікувана сума. Користувач повинен сплатити саме цю суму ( Якщо при створенні магазину не вказана похибка в параметрі "Tolerant %" ). Розраховується автоматично за допомогою наданого параметра "origin_amount", якщо не вказано інше в "payment_amount" (див. опис параметрів нижче).

PHP код

<?php

define("BCON_APIKEY", "438GH984H8GJ89F3JKEW90OTKRGE");

$curl = curl_init();
curl_setopt_array($curl,
array(  CURLOPT_URL => 'https://external-api.bcon.global/api/v2/address',
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_HTTPHEADER => array(    'Accept: application/json',
'Content-Type: application/json',
'Authorization: Bearer '.BCON_APIKEY ),
CURLOPT_POSTFIELDS => json_encode([
        "payment_currency" => "USDC", // Ticker токену в якому очікується оплата       
        "origin_amount" => "15",      // Сумма в фіатній валюті (Авторозрахунок по курсу)   
        "origin_currency" => "USD",   // В якій валюті вказаний "origin amount"               
                                      //  ( UAH, USD, EUR, etc... )
        "payment_amount" => "15",     // Не обов'язковий параметр   
        "external_id" => "test",      // Унікальний ID для відстеження платежу ( повертається з колбеком )
        "chain" => "ethereum",])      // bitcoin | binance | ethereum | tron
));

$response = curl_exec($curl);
if(curl_errno($curl)) {    
echo 'Curl Error: ' . curl_error($curl);	
curl_close($curl);
} else {    
curl_close($curl);    
echo $response;}

?>

Parameter Description:

"payment_currency" - Тікер токена, який ви хочете використовувати в рахунку-фактурі. Перегляньте список доступних токенів на панелі керування вашого особистого облікового запису.

"origin_amount" - Сума "origin_currency". Якщо ви хочете використовувати внутрішні курси системи (coingecko) для конвертації заданої суми в заданий токен. Наприклад, 50 USD в ETH.

"origin_currency" - Яку валюту ви хочете конвертувати стосовно токена? Наприклад: USD, UAH, EUR тощо… Повний список валют дивіться в налаштуваннях вашого особистого кабінету.

"payment_amount" - Необов'язковий користувацький параметр. Має пріоритет над «origin_amount», вимикає автоматичну конвертацію валюти та приймає вказане значення як суму платежу. Наприклад: 0.05 ETH або 100 USD (тікер не вказано).

"external_id" -

Унікальне значення, надане користувачем для ідентифікації платежу. Це значення не використовується сервісом для обробки транзакцій, але воно буде повернуто у зворотному виклику разом із результатом платежу.
Це дозволяє зіставити дані з колбеку з початковим запитом.

"chain" - Який блокчейн використовується. Available: bitcoin | binance | ethereum | tron

HTTP Callback

Bcon.global надішле вам зворотній callback, коли платіж надійде на вашу адресу для відстеження.

Не розумієте як це працює? Читайте в нашій статті ( Англійською ) : Read our article.

Приклад Callback

/api/callback_url?status=1&addr=1C3FrYaGgUJ8R21jJcwzFpwcrL&value=1537643&txid=4cb30849ffcaf61c0e9a32722ceb6ad5f34e630b4acb7c6dc&external_id=53475
  • Status - статус транзакції: не підтверджена, частково підтверджена, остаточно підтверджена ( 2 підтвердження );
  • Addr - адреса на яку зараховано кошти;
  • Value - отримана сумма в токенах;
  • Txid - номер транзакції в блокчейні.
  • External_id - Унікальний ID який ви вказували при створенні інвойсу ( Для ідентицікації, по якому інвойсу прийшов колбек ).

Якщо все добре, то поверне 200 HTTP status. Для BTC сумма в сатоші.

PHP код

<?php

$secret = '814fwgr-store-api-gwgwf';
$txid = $_GET['txid'];
$value = $_GET['value'];
$status = $_GET['status'];
$addr = $_GET['addr'];

//Match secret for security
if ($_GET['secret'] != $secret) {    return;} if ($status != 2) {  
//Only accept confirmed transactions  return ;}

$db = new SQLite3('payments_db.sqlite', SQLITE3_OPEN_READWRITE);
//Mark address in database as paid

$stmt = $db->prepare("UPDATE payments set addr=:addr,txid=:txid,".                        "value=:value where addr=:addr");
$stmt->bindParam(":addr", $addr);
$stmt->bindParam(":txid", $txid);
$stmt->bindParam(":value", $value);
$stmt->execute();

?>

Crypto currencies list

Поверне список токенів які доступні в bcon.global. Наразі : BTC, ETH, BNB, TRX, SOL, нативні токени цих чейнів і наступні токени в вищезазначених блокчейнах : USDT, USDC, USDS, TUSD, WBTC, WETH.

Визначення

GET https://external-api.bcon.global/api/v1/currencies

Приклад запиту

curl -H 'Authorization: Bearer 018TmI5IzJPzl3x1uCMZJvii63c8SV9vHMDA' 'https://external-api.bcon.global/api/v1/currencies'

Приклад відповіді

{"status":"Ok","data":{"currencies":[{
"id":1,"name":"BTC","iso_name":"btc","chain":"bitcoin","network":null}
"id":2,"name":"BNB","iso_name":"bnb","chain":"binance","network":null}
"id":3,"name":"ETH","iso_name":"eth","chain":"ethereum","network":null}
"id":4,"name":"USDT","iso_name":"usdt","chain":"ethereum","network":"erc-20"}
"id":5,"name":"USDC","iso_name":"usdc","chain":"ethereum","network":"erc-20"}
"id":6,"name":"USDS","iso_name":"usds","chain":"ethereum","network":"erc-20"}
"id":7,"name":"WBTC","iso_name":"wbtc","chain":"ethereum","network":"erc-20"}
"id":9,"name":"WETH","iso_name":"weth","chain":"ethereum","network":"erc-20"}
"id":10,"name":"usdt","iso_name":"usdt","chain":"binance","network":"bep-20"}
"id":11,"name":"USDC","iso_name":"usdc","chain":"binance","network":"bep-20"}
"id":12,"name":"SOL","iso_name":"sol","chain":"solana","network":null}
"id":13,"name":"USDT","iso_name":"usdt","chain":"solana","network":"spl"}
"id":14,"name":"USDC","iso_name":"usdc","chain":"solana","network":"spl"}
"id":15,"name":"USDS","iso_name":"usds","chain":"solana","network":"spl"}
"id":16,"name":"WBTC","iso_name":"wbtc","chain":"solana","network":"spl"}
"id":17,"name":"ETH","iso_name":"eth","chain":"solana","network":"spl"}
"id":18,"name":"TRX","iso_name":"trx","chain":"tron","network":null}
"id":19,"name":"USDT","iso_name":"usdt","chain":"tron","network":"trc-20"}
"id":20,"name":"USDC","iso_name":"usdc","chain":"tron","network":"trc-20"}
"id":21,"name":"TUSD","iso_name":"tusd","chain":"ethereum","network":"erc-20"}
"id":22,"name":"TUSD","iso_name":"tusd","chain":"binance","network":"bep-20"}
"id":23,"name":"TUSD","iso_name":"tusd","chain":"tron","network":"trc-20"}
]}}

Rate to fiat currency

Визначення

GET https://external-api.bcon.global/api/v1/currencies/{crypto currency name}?currency={fiat currency name} 

Приклад запиту BTC

curl -H 'Authorization: Bearer 018TmI5IzJPzl3x1uCMZJvii63c8SV9vHMDA' 'https://external-api.bcon.global/api/v1/currencies/btc?currency=eur'

Приклад запиту BNB

curl -H 'Authorization: Bearer 018TmI5IzJPzl3x1uCMZJvii63c8SV9vHMDA' 'https://external-api.bcon.global/api/v1/currencies/bnb?currency=eur'

Приклад відповіді

{"status":"Ok","data":{"price":"20324.000000000000000000"}}

Stores list

Повертає список створених магазинів (Stores) з їхніми даними. Будь-який ключ API з будь-якого магазину може бути використаний для авторизації. За замовчуванням повертає інформацію про BTC та BNB, навіть якщо вони порожні. По іншим блокчейнам повертає лише якщо вони заповнені.

Визначення

GET https://external-api.bcon.global/api/v1/stores/ 

Приклад запиту ( можна використати API key від любого блокчейну )

curl -H 'Authorization: Bearer 018TmI5IzJPzl3x1uCMZJvii63c8SV9vHMDA' 'https://external-api.bcon.global/api/v1/stores'

Приклад відповіді ( Наприклад у вас підключено 2 магазини )

{"status":"Ok","data":{"addresses":[{"id":1,"xpub":"zpubyourpublickey","binance_address":null,"name":"Opencart","tag":"test","api_key":"YourApikey","api_key_bnb":"YourApiKey1","callback_url":"https://yourdomain.com/callback&secret=secretkey1234","callback_url_bnb":null,"chains":[{"chain":"bitcoin","code":"btc","api_key":"YourApikey","callback_url":"https://yourdomain.com/callback&secret=secretkey1234","address":null,"xpub":"zpubpublickey"},{"chain":"binance","code":"bnb","api_key":"YourApiKey22","callback_url":null,"address":null}],"created_at":"2025-11-28T11:12:22.000000Z"},{"id":2,"xpub":"zpubyourpublickey","binance_address":null,"name":"WP_test","tag":"11","api_key":"YourApikey","api_key_bnb":"YourApiKey2","callback_url":"https://yourdomain.com/?secret=secretkey12345","callback_url_bnb":null,"chains":[{"chain":"bitcoin","code":"btc","api_key":"YourApikey3","callback_url":"https://yourdomain.com/?secret=secretkey12345","address":null,"xpub":"zpubpublickey"},{"chain":"binance","code":"bnb","api_key":"YourApikey4","callback_url":null,"address":null}],"created_at":"2025-12-03T08:48:48.000000Z"}]}}

Store info

Те саме, що й /api/v1/stores/, але повертає лише інформацію про конкретний магазин. Будь-який ключ API з цього магазину можна використовувати для авторизації. За замовчуванням повертає інформацію про BTC та BNB, навіть якщо вони порожні. По іншим блокчейнам повертає лише якщо вони заповнені.

Визначення

GET https://external-api.bcon.global/api/v1/stores/get_store 

Приклад запиту

<pre class="wp-block-code"><code>curl -H 'Authorization: Bearer 018TmI5IzJPzl3x1uCMZJvii63c8SV9vHMDA' 'https://external-api.bcon.global/api/v1/stores/get_store'</code></pre>

Приклад відповіді

{"status":"Ok","data":{"addresses":[{"id":1,"xpub":"zpubyourpublickey","binance_address":null,"name":"Opencart","tag":"test","api_key":"YourApikey","api_key_bnb":"YourApiKey1","callback_url":"https://yourdomain.com/callback&secret=secretkey1234","callback_url_bnb":null,"chains":[{"chain":"bitcoin","code":"btc","api_key":"YourApikey","callback_url":"https://yourdomain.com/callback&secret=secretkey1234","address":null,"xpub":"zpubpublickey"},{"chain":"binance","code":"bnb","api_key":"YourApiKey22","callback_url":null,"address":null}],"created_at":"2025-11-28T11:12:22.000000Z"}}]}}

Test Payment

Ви можете протестувати процес отримання транзакції, не витрачаючи реальних грошей.

Увійдіть до панелі користувача, потім перейдіть на сторінку "Merchants > Test Payments" та заповніть форму для тестування вигляду транзакції. Або ви можете скористатися зовнішньою кінцевою точкою API, як показано нижче:

Визначення

POST https://external-api.bcon.global/api/v1/test

Приклад запиту

{"status":"confirmed","transaction_id":"ggw43tjio3jg3g3o4","sum":"0.000005","address":"1bc34t3grrr33","currency_id":1,"store_id":216}
  • status - статус транзакції: не підтверджена, частково підтверджена, остаточно підтверджена ( 2 підтвердження );
  • transaction_id - txid (любі данні)
  • sum - сума транзакції
  • address - адреса гаманця отримання, обов'язково тільки для BTC
  • currency_id - ID токену
  • currencystore_id - id вашого Store

Приклад відповіді

{"status":"Ok","data":{"message":"Test passed successfully!"}}

Navigation

API для криптоплатежів для розробників і бізнесу

Bcon надає гнучкий API для криптоплатежів, який дозволяє розробникам і компаніям створювати безпечні некастодіальні рішення для прийому криптовалютних платежів. Наш API розроблений для повної автоматизації криптоплатежів, забезпечуючи безперешкодну інтеграцію з вебсайтами, застосунками та власними платформами.

За допомогою API Bcon Global ви можете приймати криптовалютні платежі безпосередньо на свій гаманець без кастодіального зберігання, посередників або вимог KYC.

 

Автоматизація криптоплатежів і створення рахунків

API Bcon Global дозволяє автоматично створювати рахунки, розраховувати курси конвертації з фіатної валюти в криптовалюту в режимі реального часу та генерувати посилання для криптоплатежів. Клієнти можуть оплачувати рахунки криптовалютою, тоді як продавці отримують точні суми платежів на основі актуальних курсів обміну.

Усі платіжні дані обробляються програмно, що робить API придатним для платформ електронної комерції, SaaS-продуктів, маркетплейсів і сервісів за підпискою.

 

Відстеження платежів і вебхуки в режимі реального часу

Наш API для криптоплатежів забезпечує відстеження платежів і оновлення їхнього статусу в режимі реального часу. Використовуючи вебхуки, ваша система може миттєво отримувати та надавати сповіщення про створення рахунків, успішні платежі, підтвердження транзакцій і фінальні події розрахунку.

Це забезпечує надійну автоматизацію та зменшує потребу в ручному моніторингу криптовалютних транзакцій.

 

Некастодіальна архітектура та платежі на основі гаманців

Bcon Global дотримується суворої некастодіальної моделі. API ніколи не вимагає доступу до приватних ключів і ніколи не зберігає та не контролює кошти користувачів. Вам потрібно лише вказати публічну адресу гаманця, що гарантує надходження всіх криптовалютних платежів безпосередньо на ваш гаманець.

Транзакції, оброблені поза межами API Bcon Global, не залежать від сервісу та залишаються повністю незалежними.

 

Безпечна та масштабована API-інфраструктура

API Bcon Global створений для підтримки великих обсягів транзакцій і масштабованих платіжних процесів. Наша інфраструктура розроблена для стабільної роботи, передбачуваної продуктивності та безпечної обробки платіжних даних.

Усуваючи кастодіальне зберігання та посередників, API знижує операційні ризики, зберігаючи повну прозорість завдяки використанню публічних блокчейн-мереж.

 

Зручна інтеграція та документація для розробників

Ми надаємо зрозумілу документацію API, приклади та рекомендації щодо інтеграції, щоб допомогти розробникам швидко впровадити криптовалютні платежі. Незалежно від того, чи створюєте ви простий платіжний процес або складну платіжну систему, API Bcon Global забезпечує необхідну гнучкість для реалізації індивідуальних рішень.

Якщо ви шукаєте надійний API для криптоплатежів, який ставить у пріоритет безпеку, автоматизацію та повний контроль над коштами, Bcon Global надає міцну основу для інтеграції криптовалютних платежів, орієнтованої на потреби розробників.