Python SDK

pip install py-billions-sdk

import os

from billions_sdk import BillionsApi

with BillionsApi(os.environ["BILLIONS_API_KEY"]) as api:
    invoice = api.create_invoice(
        {
            "currency": "USDT",
            "amount": "100.00",
            "idempotencyKey": "ORDER-1001-attempt-1",
            "order_no": "ORDER-1001",
            "callbackUrl": "https://example.com/webhooks/billions",
        }
    )

print(invoice["invoice_url"])

import os

from billions_sdk import AsyncBillionsApi

async with AsyncBillionsApi(os.environ["BILLIONS_API_KEY"]) as api:
    invoice = await api.get_invoice("invoice-id")

api.get_version()
api.get_currencies()
api.get_merchant_info()
api.estimate_fees(payload)
api.create_invoice(payload)
api.get_invoice(invoice_id)
api.get_invoices_by_order_no(order_no)
api.verify_invoice_paid(invoice_id, callback_data)
api.verify_invoice_paid(callback_data_with_id)

from billions_sdk import CallbackVerificationError, InvoiceNotPaidError

try:
    invoice = api.verify_invoice_paid(
        {
            "id": callback["id"],
            "status": callback["status"],
            "paid_amount": callback["paid_amount"],
        }
    )
except (InvoiceNotPaidError, CallbackVerificationError):
    # Do not mark the order as paid.
    pass