No atendemos a clientes de Rusia. Si tu negocio está ubicado en Rusia o tu servidor tiene una dirección IP rusa, todo el tráfico hacia nuestra API será bloqueado automáticamente.
Api key
Para generar una clave API, crea una tienda y luego ve a Configuración de la tienda creada > Copiar claves generadas. Para usar la clave API, pásala en el encabezado de la solicitud:
Authorization: Bearer <apikey>
Balance
Devuelve el saldo (en el servicio) y el saldo de bonificación (importe en espera de 2 confirmaciones) del usuario autorizado para las direcciones indicadas. Las direcciones pueden listarse separadas por espacios. La solicitud requiere el uso de una clave API en el encabezado Authorization: Bearer .
Esta función está disponible únicamente para BTC.
Definición
GET https://external-api.bcon.global/api/v1/user/balance?address=<Whitespace separated list of wallets addresses>
Ejemplo de solicitud
curl -H 'Authorization: Bearer 018TmI5IzJPzl3x1uCMZJvii63c8SV9vHMDA' 'https://external-api.bcon.global/api/v1/user/balance?address=1dice8EMZmqKvrGE4Qc9bUFf9PX3xaYDp 1dice97ECuByXAvqXpaYzSaQuPVvrtmz6'
Ejemplo de respuesta
{"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 code
<?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 code
Standard Node.js HTTP(S) module
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
Devuelve el historial de transacciones de múltiples direcciones Bitcoin / xpubs, considerándolos como parte de la misma billetera. Las transacciones se ordenan desde la más reciente.
Definición
GET https://external-api.bcon.global/api/v1/user/history?address=<Whitespace separated list of wallets addresses>
Ejemplo de solicitud
curl -H 'Authorization: Bearer 018TmI5IzJPzl3x1uCMZJvii63c8SV9vHMDA' 'https://external-api.bcon.global/api/v1/user/history?address=1dice8EMZmqKvrGE4Qc9bUFf9PX3xaYDp 1dice97ECuByXAvqXpaYzSaQuPVvrtmz6'
Ejemplo de respuesta
{"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}}}
Donde :
- Transaction_id - ID de la transacción en la blockchain;
- Status - estado de la transacción: unconfirmed, partially_confirmed, confirmed (2 confirmaciones);
- Preset - nombre de la plataforma en el sistema (nombre de tu tienda);
- Tag - etiqueta de la plataforma en el sistema (tag de tu tienda);
- Currency - nombre del token;
- Created_at - fecha de creación de la transacción;
- Meta - paginación para obtener transacciones adicionales.
PHP code
<?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
Devuelve los detalles de la transacción por TxID
Definición
GET https://external-api.bcon.global/api/v1/transactions/<txid>
Ejemplo de solicitud
curl -H 'Authorization: Bearer 018TmI5IzJPzl3x1uCMZJvii63c8SV9vHMDA' 'https://external-api.bcon.global/api/v1/transactions/c4978bfc9b4cd632fb37eb5f69e72530a4e'
Ejemplo de respuesta
- {"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&%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 - internal ID;
- Transaction_id - ID de la transacción en la blockchain;
- Address - dirección de salida de la transacción;
- Status - estado de la transacción: unconfirmed, partially_confirmed, confirmed (2 confirmaciones);
- Sum - cantidad de monedas;
- Log_line - URL con información del callback;
- Store - información de la tienda que recibe la transacción;
- Currency - nombre del token;
- Date - fecha y hora de la transacción.
Store list
Obtener la lista de tiendas de un usuario autorizado
GET https://external-api.bcon.global/api/v1/stores/
Ejemplo de solicitud
curl -H 'Authorization: Bearer 2cDNOlCN985d7Rx3atSDOlmMeYaxzho2uPmHheIw4eU' 'https://external-api.bcon.global/api/v1/stores'
Ejemplo de respuesta
{"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&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 - número interno en el sistema de Bcon;
- Xpub - xpub para BTC, si está especificado;
- Name - nombre de la tienda en Bcon;
- Tag - etiqueta de la tienda en Bcon;
- Api_key - clave API de BTC;
- Api_key_bnb - clave API de BNB;
- Api_key_for each of the configured blockchains - clave API para cada una de las blockchains configuradas;
- Callback_url - URL de callback de BTC;
- Callback_url_bnb - URL de callback de BNB;
- Callback_url_for each of the configured blockchains - URL de callback para cada una de las blockchains configuradas;
- Created_at - fecha de creación de la tienda.
New Address
No entiendes cómo funciona esta función? Lee nuestro artículo: How to start accepting crypto payments with the Bcon "New address" API function
Este endpoint sirve para crear una nueva dirección de seguimiento. Devuelve la dirección de la billetera que aceptará los pagos. Para obtener la última dirección ya existente, pasa el valor 1 en el parámetro reset de la solicitud: ?reset=1. Puede usarse con fines de prueba.
Definición
POST https://external-api.bcon.global/api/v2/address
POST https://external-api.bcon.global/api/v2/address?reset=1
Ejemplo de solicitud
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
Ejemplo de respuesta
ETH - {"status":"Ok","data":{"message":"Address successfully
created","address":"0x72E4CF05e4A6b123623B7443fBF8C83BD14182f1","payment_amount":"15.00403608","payment_currency":"usdc"}}
( Callback parameters description ) Where :
Address - La dirección donde se espera el pago..
Payment_amount (callback) - importe esperado. El usuario debe pagar exactamente esta cantidad. Se calcula automáticamente a partir del parámetro origin_amount, a menos que se especifique lo contrario en payment_amount (ver la descripción de los parámetros a continuación).
PHP code
<?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 of the token
"origin_amount" => "15", // Amount in origin Currency (Auto)
"origin_currency" => "USD", // Which currency should be used for
// calculation ( UAH, USD, EUR, etc... )
"payment_amount" => "15", // Not required, custom parameter
"external_id" => "test", // Custom parameter for tracking
"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;}
?>
Descripción de parámetros:
"payment_currency" - ticker del token que deseas usar en la factura. Consulta la lista de tokens disponibles en el panel de tu cuenta.
"origin_amount" - cantidad en la moneda origin_currency. Si deseas usar los tipos de cambio internos del sistema (CoinGecko), este parámetro convierte automáticamente un monto dado al token seleccionado. Por ejemplo: 50 USD a ETH.
"origin_currency" - moneda que deseas convertir respecto al token. Ejemplo: USD, UAH, EUR, etc. Consulta la lista completa de monedas en la configuración de tu cuenta.
"payment_amount" - parámetro personalizado opcional. Tiene prioridad sobre origin_amount, desactiva la conversión automática de moneda y utiliza el valor especificado como monto de pago. Por ejemplo: 0.05 ETH o 100 USD (sin ticker especificado).
"external_id" - valor único proporcionado por el usuario para identificar el pago. Este valor no es usado por el sistema para el procesamiento de la transacción, pero será devuelto en el callback junto con el resultado del pago. Permite asociar la notificación del callback con la solicitud original.
"chain" - red en la que se aceptarán los pagos. Disponible: bitcoin | binance | ethereum | tron | solana.
HTTP Callback
Bcon.global te enviará un callback cuando el pago llegue a tu dirección de seguimiento.
¿No entiendes cómo funciona esta función? Lee nuestro artículo.
Ejemplo de callback
/api/callback_url?status=1&addr=1C3FrYaGgUJ8R21jJcwzFpwcrL&value=1537643&txid=4cb30849ffcaf61c0e9a32722ceb6ad5f34e630b4acb7c6dc&external_id=53475
- Status - estado de la transacción: confirmed = 2, partially_confirmed = 1, unconfirmed = 0;
- Addr - dirección de recepción;
- Value - cantidad recibida del pago;
- Txid - ID de la transacción en la blockchain;
- External_id - valor que especificaste al crear el pago para fines de seguimiento.
Un callback se considera exitoso cuando el servidor devuelve el estado HTTP 200. Las unidades del saldo están en satoshis.
PHP code
<?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
Devuelve una lista de tokens disponibles en bcon.global. Actualmente: BTC, ETH, BNB, TRX, SOL, tokens nativos de estas cadenas y los siguientes tokens en las blockchains mencionadas: USDT, USDC, USDS, TUSD, WBTC, WETH.
Definición
GET https://external-api.bcon.global/api/v1/currencies
Ejemplo de solicitud
curl -H 'Authorization: Bearer 018TmI5IzJPzl3x1uCMZJvii63c8SV9vHMDA' 'https://external-api.bcon.global/api/v1/currencies'
Ejemplo de respuesta
{"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
Definición
GET https://external-api.bcon.global/api/v1/currencies/{crypto currency name}?currency={fiat currency name}
Ejemplo de solicitud BTC
curl -H 'Authorization: Bearer 018TmI5IzJPzl3x1uCMZJvii63c8SV9vHMDA' 'https://external-api.bcon.global/api/v1/currencies/btc?currency=eur'
Ejemplo de solicitud BNB
curl -H 'Authorization: Bearer 018TmI5IzJPzl3x1uCMZJvii63c8SV9vHMDA' 'https://external-api.bcon.global/api/v1/currencies/bnb?currency=eur'
Ejemplo de respuesta
{"status":"Ok","data":{"price":"20324.000000000000000000"}}
Stores list
Devuelve una lista de tiendas creadas con sus datos. Cualquier clave API de cualquier tienda puede utilizarse para la autorización. Por defecto, devuelve información de BTC y BNB incluso si están vacías. Otras cadenas solo se devuelven si contienen datos.
Definición
GET https://external-api.bcon.global/api/v1/stores/
Ejemplo de solicitud ( Puedes utilizar cualquier clave API de cualquiera de tus tiendas )
curl -H 'Authorization: Bearer 018TmI5IzJPzl3x1uCMZJvii63c8SV9vHMDA' 'https://external-api.bcon.global/api/v1/stores'
Ejemplo de respuesta ( For example you got 2 stores )
{"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
Igual que /api/v1/stores/, pero solo devuelve información sobre una tienda específica. Cualquier clave API de esta tienda puede utilizarse para la autorización. Por defecto, devuelve información de BTC y BNB incluso si están vacías. Otras cadenas solo se devuelven si contienen datos.
Definición
GET https://external-api.bcon.global/api/v1/stores/get_store
Ejemplo de solicitud
<pre class="wp-block-code"><code>curl -H 'Authorization: Bearer 018TmI5IzJPzl3x1uCMZJvii63c8SV9vHMDA' 'https://external-api.bcon.global/api/v1/stores/get_store'</code></pre>
Ejemplo de respuesta
{"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
Puedes probar el flujo de recepción de una transacción sin gastar dinero real.
Inicia sesión en el panel de usuario, luego ve a la página “Merchants > Test Payments” y completa el formulario para probar la simulación de una transacción. También puedes usar el endpoint de la API externa como se muestra a continuación:
Definición
POST https://external-api.bcon.global/api/v1/test
Ejemplo de solicitud
{"status":"confirmed","transaction_id":"ggw43tjio3jg3g3o4","sum":"0.000005","address":"1bc34t3grrr33","currency_id":1,"store_id":216}
- status - (confirmed, partially_confirmed, unconfirmed);
- transaction_id - txid (cualquier cadena);
- sum - suma de la transacción;
- address - dirección de salida, obligatoria si la tienda es BTC;
- memo - obligatorio si la tienda es BNB;
- currency_id - ID de la moneda;
- store_id - ID de la tienda.
Ejemplo de respuesta
{"status":"Ok","data":{"message":"Test passed successfully!"}}