zpay — ZPay Python SDK

English | 中文

Async Python client for the ZPay payment gateway. Supports Alipay and WeChat Pay via redirect URLs, server-to-server API calls, order queries, refunds, and callback verification.

Installation

pip install zpay

Requirements: Python ≥ 3.10, aiohttp

Quick Start

import asyncio
from zpay import ZPayClient

async def main():
    async with ZPayClient(pid="your_pid", key="your_key") as client:

        # 1. Redirect URL (no HTTP request)
        url = client.create_payment_url(
            name="iPhone 17",
            money="599.00",
            out_trade_no="ORDER_001",
            notify_url="https://yoursite.com/notify",
            return_url="https://yoursite.com/return",
            type="alipay",
        )
        print("Pay URL:", url)

        # 2. API payment — returns payurl / qrcode / img
        resp = await client.create_payment(
            name="iPhone 17",
            money="599.00",
            out_trade_no="ORDER_002",
            notify_url="https://yoursite.com/notify",
            clientip="1.2.3.4",
            type="wxpay",
        )
        print("QR Code:", resp.qrcode)

        # 3. Query order
        order = await client.query_order(out_trade_no="ORDER_002")
        print("Status:", order.status)

        # 4. Refund
        refund = await client.refund(out_trade_no="ORDER_002", money="599.00")
        print(refund.msg)

        # 5. Verify callback notification
        payload = client.verify_notification(request_params)
        if payload.is_paid:
            print("Payment confirmed!")

asyncio.run(main())

API Reference

ZPayClient(pid, key, base_url?, session?)

Methods

Payment Types

License

MIT

zpay — ZPay Python SDK 中文

English | 中文

ZPay 支付网关的异步 Python 客户端，支持支付宝、微信支付的跳转收款、服务端 API 下单、订单查询、退款以及回调验签。

安装

pip install zpay

环境要求： Python ≥ 3.10，依赖 aiohttp

快速开始

import asyncio
from zpay import ZPayClient

async def main():
    async with ZPayClient(pid="your_pid", key="your_key") as client:

        # 1. 生成跳转收款 URL（不发起 HTTP 请求）
        url = client.create_payment_url(
            name="iPhone 17",
            money="599.00",
            out_trade_no="ORDER_001",
            notify_url="https://yoursite.com/notify",
            return_url="https://yoursite.com/return",
            type="alipay",
        )
        print("支付链接：", url)

        # 2. 服务端 API 下单（返回 payurl / qrcode / img）
        resp = await client.create_payment(
            name="iPhone 17",
            money="599.00",
            out_trade_no="ORDER_002",
            notify_url="https://yoursite.com/notify",
            clientip="1.2.3.4",
            type="wxpay",
        )
        print("二维码：", resp.qrcode)

        # 3. 查询订单
        order = await client.query_order(out_trade_no="ORDER_002")
        print("订单状态：", order.status)

        # 4. 退款
        refund = await client.refund(out_trade_no="ORDER_002", money="599.00")
        print(refund.msg)

        # 5. 验证异步回调通知
        payload = client.verify_notification(request_params)
        if payload.is_paid:
            print("支付成功！")

asyncio.run(main())

API 说明

ZPayClient(pid, key, base_url?, session?)

方法列表

支付方式

开源协议

MIT