Python SDK

pip install sohopay

import os
from sohopay import SohoPay

sohopay = SohoPay(
    api_key=os.environ["SOHOPAY_API_KEY"],  # sk_test_... or sk_live_...
    environment="sandbox",  # "sandbox" (default) | "mainnet"
)

import os
from sohopay import SohoPay

sohopay = SohoPay(api_key=os.environ["SOHOPAY_API_KEY"])

# 1. Create an agent with a credit line
agent = sohopay.agents.create(
    merchant_id="mch_sandbox_demo",
    name="my-first-agent",
    credit_limit="50.00",
    daily_limit="10.00",
    operator_acknowledgment=True,
)

# 2. Create an order (expires after 10 minutes)
order = sohopay.orders.create(
    merchant_id="mch_sandbox_demo",
    agent_id=agent.agent_id,
    amount="1.00",
)

# 3. Submit the payment (sandbox auto-signs)
payment = sohopay.payments.submit(
    order_id=order.order_id,
    agent_id=agent.agent_id,
    signature="sandbox_auto",
)

print(payment.payment_id, payment.status)

import os
from flask import Flask, request
from sohopay import SohoPay

app = Flask(__name__)
sohopay = SohoPay(api_key=os.environ["SOHOPAY_API_KEY"])

@app.post("/webhooks/sohopay")
def sohopay_webhook():
    event = sohopay.webhooks.verify(
        payload=request.get_data(),
        signature=request.headers["Sohopay-Signature"],
        timestamp=request.headers["Sohopay-Timestamp"],
        secret=os.environ["SOHOPAY_WEBHOOK_SECRET"],
    )

    if event.type == "payment.settled":
        print("Settled:", event.data.payment_id, event.data.settlement_tx)
    return "", 200  # respond fast; do heavy work async

from sohopay import SohoPay, SohoPayError

try:
    sohopay.payments.submit(order_id=order_id, agent_id=agent_id, signature=sig)
except SohoPayError as err:
    if err.code == "INSUFFICIENT_CREDIT":
        # 402 — top up vault collateral or lower the order amount
        ...
    elif err.code == "ORDER_EXPIRED":
        # 400 — orders live 10 minutes; recreate and resubmit
        ...
    else:
        print(err.status, err.code, err.request_id)
        raise