Saltar al contenido principal

Transacciones

Verificación de transacciones, cancelación de transacciones y realización de un pago.

Crear Transacción​

Para crear una transacción, utiliza la ruta /create_transaction, proporciona un token de acceso, correo electrónico del cliente, cantidad a pagar (en USD), el tipo específico de criptomoneda que se utilizará y etiqueta.

Ejemplo con Curl​

curl --header "Content-Type: application/json" \ --request POST \ --data '{"access_token": "test_access_token", "email": "[email protected]", "amount": 0.05, "crypto_selected": "MARS", "label": "another_identifier_123456789"}' \ https://quinix.byteconnect.us/create_transaction

Ejemplo con Python​

import requests
from os import getenv


access_token = getenv("access_token")
customer_email = "[email protected]"
payment_amount = 0.05
crypto_ticker_name = "MARS"
label = "another_identifier_123456789"
body = {"access_token" : access_token, "email": customer_email, "amount": payment_amount, "crypto_selected": crypto_ticker_name, "label": label}

url = getenv("bytefederal_api_url")

request = requests.post(f"{url}/create_transaction", json=body)
response = request.json()
print(response)

Ejemplo con NodeJs​

async function CreateTransaction() {
    const accessToken = process.env.ACCESSTOKEN;
    const customerEmail = "[email protected]";
    const payAmount = 0.05;
    const cryptoTickerName = "MARS";
    const label = "another_identifier_123456789";
    const bodyData = {
        "access_token": accessToken,
        "email": customerEmail,
        "amount": payAmount,
        "crypto_selected": cryptoTickerName,
        "label": label
    }
    const url = `${process.env.BYTECONNECTURL}/create_transaction`;
    const request = await fetch(url, {
            method: "POST", 
            body=JSON,stringify(bodyData),
            headers: {
                "Content-Type": "application/json"
            }
        });
    const response = await request.json();
    console.log(response);
}

Códigos HTTP​

200​

Devuelve una respuesta codificada en JSON con el id, correo electrónico utilizado, descripción, dirección de billetera, cantidad de cripto, cantidad en USD, sello de tiempo de creación, etiqueta, criptomoneda, estado y código QR.

401​

Una de las respuestas proporcionadas en el payload es incorrecta.

Verificar el estado de la transacción​

Para verificar el estado actual de una transacción, se necesita proporcionar un token de acceso, id de la transacción y correo electrónico.

Ejemplo con Curl​

curl --header "Content-Type: application/json" \ --request POST \ --data '{"access_token": "test_access_token", "transaction_id": 012345}' \ https://quinix.byteconnect.us/check_transaction

Ejemplo con Python​

import requests
from os import getenv

access_token = getenv("access_token")
transaction_id = 012345
body = {"access_token" : access_token,  "transaction_id": transaction_id}

url = getenv("bytefederal_api_url")

request = requests.post(f"{url}/check_transaction", json=body)
response = request.json()
print(response)

Ejemplo con NodeJs​

async function CheckTransaction() {
    const accessToken = process.env.ACCESSTOKEN;
    const transactionID = 012345
    const bodyData = {
        "access_token": accessToken,
        "transaction_id": transactionID
    }
    const url = `${process.env.BYTECONNECTURL}/check_transaction`;
    const request = await fetch(url, {
            method: "POST", 
            body=JSON,stringify(bodyData),
            headers: {
                "Content-Type": "application/json"
            }
        });
    const response = await request.json();
    console.log(response);
}

Códigos HTTP​

200​

Devuelve una respuesta codificada en JSON con el estado, id de la transacción, correo electrónico, descripción, dirección de la billetera, cantidad de cripto, cantidad en USD, marca de tiempo de creación en formato de cadena ISO, etiqueta de la transacción, moneda seleccionada y estado.

401​

Uno de los elementos del payload proporcionado es incorrecto.

Cancelar una transacción​

Para cancelar una transacción en curso, se necesitará proporcionar un token de acceso y el id de la transacción. Después de proporcionar estos campos, la transacción cambiará al estado de "Cancelada".

Ejemplo con Curl​

curl --header "Content-Type: application/json" \ --request POST \ --data '{"access_token": "test_access_token", "transaction_id": 0.12345}' \ https://quinix.byteconnect.us/cancel_transaction

Ejemplo con Python​

import requests
from os import getenv


access_token = getenv("access_token")
transaction_id = 012345
body = {"access_token" : access_token, "transaction_id": transaction_id}

url = getenv("bytefederal_api_url")

request = requests.post(f"{url}/cancel_transaction", json=body)
response = request.json()
print(response)

Ejemplo con NodeJs​

async function CancelTransaction() {
    const accessToken = process.env.ACCESSTOKEN;
    const transactionID = 012345
    const bodyData = {
        "access_token": accessToken,
        "transaction_id": transactionID
    }
    const url = `${process.env.BYTECONNECTURL}/cancel_transaction`;
    const request = await fetch(url, {
            method: "POST", 
            body=JSON,stringify(bodyData),
            headers: {
                "Content-Type": "application/json"
            }
        });
    const response = await request.json();
    console.log(response);
}

Códigos HTTP​

200​

Devuelve una respuesta codificada en JSON con el estado de la transacción siendo cancelada, y el token de actualización.

401​

El payload no pudo ser analizado, hay un campo incorrecto.

Códigos de Estado de Transacción​

A continuación se muestran los códigos de estado de la transacción al usar /check_transaction.

  • Started: Cuando se crea la transacción`
  • Timedout: Después de 15 minutos de espera
  • Cancelled: Si se llama a la ruta /canceltransaction
  • Pending: Se recibió dinero pero no se confirmó
  • Confirmed: La criptomoneda fue confirmada en la blockchain
  • Succeeded: Transacción completada