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.get_invoice_from_webhook(webhook)
api.verify_invoice_paid(invoice_id, callback_data)
api.verify_invoice_paid(callback_data_with_id)

invoice = api.get_invoice_from_webhook(webhook)

if invoice["status"] == "processing":
    # Update visible payment state, but do not fulfill the order.
    pass
elif invoice["status"] == "completed":
    # Fulfill the order exactly once.
    pass

from billions_sdk import CallbackVerificationError, InvoiceNotPaidError

try:
    invoice = api.verify_invoice_paid(
        webhook
    )
except (InvoiceNotPaidError, CallbackVerificationError):
    # Do not mark the order as paid.
    pass