Docs

Inicio estrategia

Como Biwse es una plataforma amigable para desarrolladores, es fácil empezar a crear cosas de jugadores. En este artículo usted conseguirá a través de la inscripción a la solución de trabajo y confiar en nosotros - es realy menos de 5 minutos.

Es necesario término sign up para que una cuenta de Biwse comience.

Paso 1: API Token

Una vez que tenga una cuenta registrada, puede crear una aplicación. La aplicación es su cartera a la que puede acceder a través de nuestra API. Puede crear tantas aplicaciones como desee para impulsar diferentes proyectos. El token API es específico de la aplicación, por lo que le permite mover tokens a través de sus proyectos más fácilmente.

Puede crear un nuevo token en la página de la aplicación.

Note: Guardar token en un lugar seguro, le permite acceder a la API de Biwse y gastar fondos.

Consejo: Puede realizar solicitudes de API con la prueba token test_token_I6Ims4a2dvNXJLUzMy y le dará respuestas con los datos de prueba.

Paso 2: Página de facturación

Con el token de su API puede generar nueva dirección:

Solicitud De Ejemplo:

                                
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"}
                            

Use la dirección generada para crear la página de facturación. También necesita especificar la cantidad que desea recibir:

Solicitud De Ejemplo:

                                

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..."}
                            

Usted puede Turquía el enlace de respuesta y ver su página de la factura está listo para trabajar!

Y ahora qué?
Cliente de PHP de Biwse

TLa biblioteca PHP de Biwse proporciona acceso a la API de Biwse.

Instalar el paquete con:


composer require biwse/biwse-php
                            

El paquete necesita ser configurado con el token de acceso a la aplicación que está disponible en su Biwse Dashboard

configurar el cliente:


use Biwse\Client\Biwse;
// create API client using your token
$app = new Biwse("YOUR_TOKEN");
                            
Obtener equilibrio

$res = $app->balance();
$total = $res->total;
$confirmed = $res->confirmed;
                            
Nueva dirección

$res = $app->newAddress("https://your_cllback_link.com");
$address = $res->address;
                            
Enviar dinero

$res = $app->send("ADDRESS",0.001);
$txHash = $res->tx_hash;
                            
Multi enviar dinero

$res = $app->multiSend([ "payments" =>[
            ["address" => "ADDRESS_1","amount" => 0.001],
            ["address" => "ADDRESS_2","amount" => 0.001],
        ]
    ]);
$txHash = $res->tx_hash;
                            
Nueva factura

$res = $app->newInvoice("YOUR_ADDRESS",0.1);
$invoiceUrl = $res->url;
                            
Cliente Biwse JS

La biblioteca JS de Biwse proporciona acceso a la API de Biwse.

Instalar el paquete con:


npm install biwse-js --save
                            

El paquete necesita ser configurado con el token de acceso a la aplicación que está disponible en su Biwse Dashboard

configurar el cliente:


import BiwseAPI from 'biwse-js' 
// create API client using your token
const app = new BiwseAPI('your_token...')
                            
Nueva dirección

Puede omitir argumentos de devolución de llamada (véase referencia API)


const { address, status } = await app.newAddress('https://your_address...')
                            
Nueva factura

const response = await app.newInvoice('btc_address...', 0.001)
const { status, id, url } = response
                            
Obtener equilibrio

const response = await app.balance()
const { total, confirmed, status } = response
                            
Enviar dinero

const { tx_hash, status } = await app.send('btc_address...', 0.001)
                            
Multi enviar dinero

const { tx_hash, status } = await app.multiSend({payments: [
	{address: 'btc_address_1', amount: 0.001},
	{address: 'btc_address_2', amount: 0.001},
]})
                            
Cómo empezar

En primer lugar, necesitará su clave de API que proporcionamos para las carteras. Puede obtener las llaves en la configuración de su aplicación. Tienes que usar la clave de la API en la interacción con biwse.com - qué Todas las peticiones tienen que contener estas cabeceras:

Content-Type:application/json
Accept:application/json
Authorization:Bearer YOUR_TOKEN

YOUR_TOKEN – la clave que recibió en la configuración de la aplicación.


Factura General

En primer lugar, usted necesitará su identificación de Cliente que proporcionamos para merchant page. Puede obtener el id del Cliente en la configuración de su página de comerciante.

Este método le permite crear páginas de facturas donde los usuarios pueden elegir la moneda a utilizar para el pago.

Tipo de solicitud:POST
URL:/general_invoice/CLIENT_ID

Para recibir la página de facturación tienes que enviar una solicitud de correo A esta dirección - https://biwse.com/general_invoice/CLIENT_ID

Solicitud De Ejemplo

                                
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) - La cantidad que desea obtener en USD;
invoice_number - Su número de factura interna;
callback_link - Es su dirección URL única que recibirá una solicitud de POST sobre los fondos de crédito.

En respuesta a la solicitud recibirá JSON con el siguiente contenido:

Example Response:

                                
{
    "status": true,
    "id": "8bef57df314eb6b98c7dbad5c14355d34a17f2439b777f2175cd0de484773c6f",
    "url": "https://biwse.com/general_invoice/8bef57df314eb6b98c7dbad5c14355d34a17f2439b777f2175cd0de484773c6f"
}                               
                            

Obtener un balance de la solicitud
Tipo de solicitud:GET
URL:/api/v1/balance

Para recibir el saldo tienes que enviar una solicitud GET a dirección - https://biwse.com/api/v1/balance

Solicitud De Ejemplo:

                                
curl -X GET \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-H "Authorization: Bearer YOUR_TOKEN" \
https://biwse.com/api/v1/balance
                            

En respuesta a la solicitud recibirá JSON con el siguiente contenido:

Example Response:

                                
{
    "status": true,
    "total": 0.5,
    "confirmed": 0.5
}
                            

total – Saldo total;
confirmed - Saldo confirmado.


Obtener nueva dirección
Tipo de solicitud:GET
URL:/api/v1/new_address

Para recibir la dirección tienes que enviar una petición GET a dirección - https://biwse.com/api/v1/new_address

Solicitud De Ejemplo

                                
curl -X GET \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-H "Authorization: Bearer YOUR_TOKEN" \
https://biwse.com/api/v1/new_address
                            

En respuesta a la solicitud recibirá JSON con el siguiente contenido:

Example Response:


{
    "status": true,
    "address": "YOUR_NEW_ADDRESS"
}


Envío de dinero
Tipo de solicitud:POST
URL:/api/v1/send

Para enviar fondos desde tu cartera tienes que enviar una solicitud de POST A esta dirección - https://biwse.com/api/v1/send

Solicitud De Ejemplo


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

ISi la transacción tiene éxito, recibirá JSON en respuesta a la solicitud con el siguiente contenido::

Example Response:


{
    "status": true,
    "tx_hash": "TX_HASH"
}
                                

tx_hash – Hash transacción en la red;

Si necesita enviar varios pagos en una transacción tiene que enviar una solicitud de POST A esta dirección - https://biwse.com/api/v1/multi_send

Solicitud De Ejemplo


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

El número máximo de direcciones permitidas para una transacción es 100.


Crear una página de facturación
Tipo de solicitudPOST
URL:/api/v1/new_invoice

La factura es una página de recibo de pago.

Usted tiene todos los datos necesarios para crear su página de facturación, pero si desea utilizar nuestra página de facturación tiene que enviar una solicitud de correo A esta dirección - https://biwse.com/api/v1/new_invoice

En respuesta a la solicitud recibirá JSON con el siguiente contenido:

Example Response:


{
    "status": true,
    "id": "HASH",
    "address": "ADDRESS",
    "url": "https://biwse.com/invoice/HASH"
}

url - Es una dirección de página de pago ( la página está disponible en 2 horas);
id - es un identificador de pago único.

La factura está disponible dentro de 2 horas después de creado.

Solicitud De Ejemplo


curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-H "Authorization: Bearer YOUR_TOKEN" \
-d '{
"amount": 0.001,
"callback_link": "https://yoursite.com"

}' \
https://biwse.com/api/v1/new_invoice

amount – Importe de pago;
callback_link - es su dirección URL única que recibirá una solicitud de POST sobre los fondos de crédito con el contenido siguiente.

                                    
{
    "amount":  0.1,
    "confs": 1,
    "address": "ADDRESS",
    "tx_hash": "TX_HASH",
    "type": "BTC",
    "accepted": "1",
    "verification_hash": "md5(SECURITY_KEY+ADDRESS)"
}
                                

amount – Importe de pago;
confs – Es el número de transacciones confirmadas;
address – Dirección a la que se han recibido los fondos;
tx_hash – Hash transacción en la red;
type – Tipo de moneda;
accepted – Indica si la factura se pagó en su totalidad ("1" or "0");
verification_hash – Es nuestro único hash para verificar la autenticidad de la solicitud;
SECURITY_KEY – Es tu llave secreta de la aplicación. No lo confundas con Token..

Le enviaremos notificaciones hasta que el pago reciba seis confirmaciones. Pararemos el envío de notificaciones si para otra solicitud recibimos un Formato de respuesta JSON con el contenido siguiente:


{
    "accepted": true
}

En este caso, nuestro sistema considerará que su pago es aceptado.


Transactions at address
Tipo de solicitudGET
URL:/api/v1/get_transactions/{ADDRESS}

To receive all incoming transactions at the address you need to send a GET request to this address - https://biwse.com/api/v1/get_transactions/{ADDRESS}

Solicitud De Ejemplo


curl -X GET \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-H "Authorization: Bearer YOUR_TOKEN" \
    https://biwse.com/api/v1/get_transactions/{ADDRESS}

En respuesta a la solicitud recibirá JSON con el siguiente contenido:

Example Response:


{
    "status": true,
    "txs": [
        {
            "hash": "67062d8016469085b7fc31f24f6a6e3d378e86d8bec09e5baac4998bd2b5831d",
            "amount": "0.1459",
            "created_at": "2019-03-16 10:08:18"
        },
        {
            "hash": "8875e9e8007ce01e456b708b245136e93e6f382f4b075b8392d7574d67279923",
            "amount": "0.1459",
            "created_at": "2019-03-16 10:08:16"
        },
        {
            "hash": "2615a4a7c3a9dd4d1663037a82f27f66b8f603e85162fa0fba34d95a4814f1ab",
            "amount": "0.0459",
            "created_at": "2019-03-16 10:07:56"
        }
    ]
}

Get invoice status
Tipo de solicitudGET
URL:/api/v1/get_invoice/{invoice_id}

To get information about the payment you need to send a GET request to this address - https://biwse.com/api/v1/get_invoice/{invoice_id}

Solicitud De Ejemplo


curl -X GET \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-H "Authorization: Bearer YOUR_TOKEN" \
    https://biwse.com/api/v1/get_invoice/{INVOICE_ID}

En respuesta a la solicitud recibirá JSON con el siguiente contenido:

Example Response:


{
    "status": true,
    "data": {
        "amount": 0.02,
        "confs": 4,
        "address": "mrnWggWKtK9wMFqc3yM4823ygc5Zr8g5Si",
        "tx_hash": "c69cb40b6947e24e78def49d979c97ab60fad98b29dd7bb94bbef3c561d9211d",
        "type": "BTC",
        "accepted": true,
        "verification_hash": "e014a9f36568a804d306c50cc5568e30"
    }
}