pyvelv 0.1.0

Async Python SDK for the Velvpay payment gateway

Pyvelv

Async Python SDK for the Velvpay payment gateway.

Installation

pip install pyvelv
# or
poetry add pyvelv

Quick Start

import asyncio
from pyvelv import Velvpay
from pyvelv.models import CreatePaymentLinkRequest

async def main():
    async with Velvpay(secret_key="your-secret-key") as client:
        # Create a payment link
        response = await client.payment_links.create(
            CreatePaymentLinkRequest(
                amount=1500.00,
                currency="NGN",
                description="Order #12345",
            )
        )
        print(response.data.url)

        # Verify a transaction
        txn = await client.transactions.verify(reference="ref_abc123")
        print(txn.data.status)

asyncio.run(main())

Authentication

Pyvelv handles authentication automatically. The SDK generates the required api-key header using a legacy OpenSSL EVP_BytesToKey routine (AES-256-CBC) with a random 8-byte salt on every request.

Simply pass your Velvpay secret key when initializing the client:

client = Velvpay(secret_key="sk_live_...")

Resources

Resource	Methods
payment_links	create(), get(), list()
transactions	get(), list(), verify()

License

MIT