Поскольку Biwse является дружественной к разработчикам платформой, легко начать создавать удивительные вещи. В этой статье вы пройдете регистрацию. Доверитесь нам - это менее 5 минут.
Чтобы начать, вам необходимо зарегистрироваться в Biwse.
После регистрации Учетной записи вы можете создать приложение. Приложение - это ваш кошелек, к которому вы можете получить доступ через наш API. Вы можете создать столько приложений, сколько Вы захотите, чтобы руководить разными проектами. Токен API относится к конкретному приложению, что позволяет более легко управлять токенами в проектах.
Создать новый токен можно на странице приложения.
Запись: Сохраните токен в надежном месте, это позволит вам получить доступ к Biwse API и тратить средства.
Tip: Вы можете выполнять запросы API с помощью test token test_token_I6Ims4a2dvNXJLUzMy, и он даст вам ответы с тестовыми данными.
С помощью токена API можно создать новый адрес:
curl -X GET \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-H "Authorization: Bearer YOUR_TOKEN" \
https://biwse.com/api/v1/new_address
# Response:
# {"status": true, "address": "YOUR_NEW_ADDRESS"}
Используйте сгенерированный адрес для создания страницы счета. Также нужно указать сумму, которую вы хотите получить:
curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-H "Authorization: Bearer YOUR_TOKEN" \
-d '{
"address": "ADDRESS",
"amount": 0.001
}' \
https://biwse.com/api/v1/new_invoice
# Response:
#{"status":true,"id":"invoice_id...","url":"https://biwse.com/invoice/invoice_id..."}
Вы можете перейти по ссылке из ответа и увидеть, что ваша страница счета готова к работе!
Библиотека PHP Biwse предоставляет доступ к API Biwse.
composer require biwse/biwse-php
Пакет необходимо настроить с помощью токена доступа приложения, который доступен на панели Biwse
use Biwse\Client\Biwse;
// create API client using your token
$app = new Biwse("YOUR_TOKEN");
$res = $app->balance();
$total = $res->total;
$confirmed = $res->confirmed;
$res = $app->newAddress("https://your_cllback_link.com");
$address = $res->address;
$res = $app->send("ADDRESS",0.001);
$txHash = $res->tx_hash;
$res = $app->multiSend([ "payments" =>[
["address" => "ADDRESS_1","amount" => 0.001],
["address" => "ADDRESS_2","amount" => 0.001],
]
]);
$txHash = $res->tx_hash;
$res = $app->newInvoice("YOUR_ADDRESS",0.1);
$invoiceUrl = $res->url;
Библиотека Biwse JS предоставляет доступ к API Biwse.
npm install biwse-js --save
Пакет необходимо настроить с помощью токена доступа приложения, который доступен на панели Biwse
import BiwseAPI from 'biwse-js'
// create API client using your token
const app = new BiwseAPI('your_token...')
опустить аргумент callback (см. справочник по API )
const { address, status } = await app.newAddress('https://your_address...')
const response = await app.newInvoice('btc_address...', 0.001)
const { status, id, url } = response
const response = await app.balance()
const { total, confirmed, status } = response
const { tx_hash, status } = await app.send('btc_address...', 0.001)
const { tx_hash, status } = await app.multiSend({payments: [
{address: 'btc_address_1', amount: 0.001},
{address: 'btc_address_2', amount: 0.001},
]})
Во-первых, вам понадобится ваш API-ключ, который мы предоставляем для кошельков. Вы можете получить ключи в настройках Вашего приложения. Вы должны использовать API-ключ во взаимодействии с biwse.com. Все запросы должны содержать эти заголовки:
Content-Type: | application/json |
Accept: | application/json |
Authorization: | Bearer YOUR_TOKEN |
YOUR_TOKEN – ключ, полученный в настройках приложения.
Во-первых, вам понадобится Ваш идентификатор клиента, который мы предоставляем для страницы merchant. Вы можете получить идентификатор клиента в настройках страницы merchant.
Этот метод позволяет создавать страницы накладных, на которых пользователи могут выбирать валюту для оплаты.
Тип запроса: | POST |
URL: | /general_invoice/CLIENT_ID |
Для получения страницы счета необходимо отправить запрос POST на этот адрес - https://biwse.com/general_invoice/CLIENT_ID
curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{
"amount_usd": 100,
"invoice_number": "#001",
"callback_link": "https://yoursite.com"
}' \
https://biwse.com/general_invoice/CLIENT_ID
amount_usd (required) - Сумма, которую вы хотите получить в долларах США;
invoice_number - Ваш внутренний номер счета;
callback_link - Ваш уникальный URL-адрес, на который будет отправлен запрос о зачислении средств.
В ответ на запрос вы получаете JSON со следующим содержимым:
{
"status": true,
"id": "8bef57df314eb6b98c7dbad5c14355d34a17f2439b777f2175cd0de484773c6f",
"url": "https://biwse.com/general_invoice/8bef57df314eb6b98c7dbad5c14355d34a17f2439b777f2175cd0de484773c6f"
}
Тип запроса: | GET |
URL: | /api/v1/balance |
Для получения баланса необходимо отправить запрос GET на этот адрес - https://biwse.com/api/v1/balance
curl -X GET \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-H "Authorization: Bearer YOUR_TOKEN" \
https://biwse.com/api/v1/balance
В ответ на запрос вы получаете JSON со следующим содержимым:
{
"status": true,
"total": 0.5,
"confirmed": 0.5
}
total – Общая сумма баланса;
confirmed - Подтвержденная сумма баланса.
Тип запроса: | GET|POST |
URL: | /api/v1/new_address |
Для получения адреса необходимо отправить запрос GET на этот адрес - https://biwse.com/api/v1/new_address
curl -X GET \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-H "Authorization: Bearer YOUR_TOKEN" \
https://biwse.com/api/v1/new_address
В ответ на запрос вы получаете JSON со следующим содержимым:
{
"status": true,
"address": "YOUR_NEW_ADDRESS"
}
Если вы хотите получать уведомления о зачислении средств на адрес, то отправьте запрос POST на этот адрес https://biwse.com/api/v1/new_address
curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-H "Authorization: Bearer YOUR_TOKEN" \
-d '{
"callback_link": "https://yoursite.com",
}' \
https://biwse.com/api/v1/new_address
callback_link - Ваш уникальный URL-адрес, на который будет отправлен запрос о зачислении средств со следующим содержанием.
{
"amount": 0.1,
"confs": 1,
"address": "ADDRESS",
"tx_hash": "TX_HASH",
"type": "BTC",
"accepted": "1",
"verification_hash": "md5(SECRET_KEY+ADDRESS)"
}
amount – Сумма платежа;
confs – Количество подтвержденных транзакций;
address – Адрес, по которому были получены средства;
tx_hash – Хэш транзакции в сети;
type – Тип криптовалюты;
accepted – Указывает, был ли счет полностью оплачен ("1" или "0");
verification_hash – Наш уникальный хэш для проверки подлинности запроса;
SECRET_KEY – Является секретным ключом приложения. Не путайте его с Токеном.
Мы будем отправлять вам уведомления до тех пор, пока платеж не получит шесть подтверждений. Мы прекратим отправлять вам уведомления, если для другого запроса мы получим формат ответа JSON со следующим содержимым:
{
"accepted": true
}
В таком случае, наша система будет считать, что ваш платеж принят.
Тип запроса: | POST |
URL: | /api/v1/send |
Для того, чтобы отправить средства с вашего кошелька, вам необходимо отправить POST запрос на этот адрес - https://biwse.com/api/v1/send
curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-H "Authorization: Bearer YOUR_TOKEN" \
-d '{
"address": "ADDRESS",
"amount": 0.001
}' \
https://biwse.com/api/v1/send
Если транзакция прошла успешно, вы получите JSON в ответ на запрос следующего содержания:
{
"status": true,
"tx_hash": "TX_HASH"
}
tx_hash – Хэш транзакции в сети;
Если вам нужно отправить несколько платежей в одной транзакции, вы должны отправить запрос POST на этот адрес - https://biwse.com/api/v1/multi_send
curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-H "Authorization: Bearer YOUR_TOKEN" \
-d '{
"payments":[
{
"address": "YOUR_ADDRESS_1",
"amount": 0.001
},
{
"address": "YOUR_ADDRESS_2",
"amount": 0.001
}
]
}' \
https://biwse.com/api/v1/multi_send
Максимальное количество разрешенных адресов для одной сделки-100.
Тип запроса | POST |
URL: | /api/v1/new_invoice |
Счет - это страница квитанции об оплате.
У вас есть все необходимые данные для создания страницы счета, но если вы хотите использовать нашу страницу счета, вы должны отправить запрос POST на этот адрес - https://biwse.com/api/v1/new_invoice
curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-H "Authorization: Bearer YOUR_TOKEN" \
-d '{
"address": "ADDRESS",
"amount": 0.001
}' \
https://biwse.com/api/v1/new_invoice
address - это адрес, на который вы хотите получать платежи;
amount – Сумма платежа.
В ответ на запрос вы получаете JSON со следующим содержимым:
{
"status": true,
"id": "HASH",
"url": "https://biwse.com/invoice/HASH"
}
url - это адрес платежной страницы ( страница доступна в течении 2 часов);
id - уникальный идентификатор платежа.
Счет доступен в течение 2 часов после его создания.