开始接入

开发者

简单易用的 API,让你的 AI Agent 快速拥有支付能力。完整的文档和 SDK,5 分钟完成接入。

快速接入

标准化 RESTful API,5 分钟完成接入

🛡️

安全可靠

PCI DSS 认证,银行级别安全

📚

完整文档

详细 API 文档和代码示例

💬

技术支持

7×24 技术支持团队

API 文档

安装 SDK

# Python
pip install newgen-sdk

# Node.js
npm install newgen-sdk

# Go
go get github.com/newgen/newgen-sdk

初始化客户端

# Python
import newgen

client = newgen.Client(
    api_key="your-api-key",
    environment="sandbox"  # or "production"
)

创建虚拟卡

# 创建一张虚拟卡
card = client.cards.create(
    amount=1000,
    currency="USD",
    description="AI Agent Payment",
    metadata={
        "agent_id": "agent-001",
        "purpose": "subscription"
    }
)

print(card.virtual_card_number)
# 4532-XXXX-XXXX-1234

print(card.cvv)
# 123

print(card.expiry)
# 12/2028

查询卡详情

# 查询卡信息
card = client.cards.retrieve("card_id")

print(card.balance)
# 500.00

print(card.status)
# active

充值虚拟卡

# 为虚拟卡充值
topup = client.cards.topup(
    card_id="card_id",
    amount=500,
    currency="USD"
)

print(topup.new_balance)
# 1500.00

创建支付链接

# 创建支付链接,用于接受客户付款
payment = client.payments.create(
    amount=99.00,
    currency="USD",
    description="Premium Plan",
    callback_url="https://your-app.com/webhook"
)

print(payment.checkout_url)
# https://checkout.newgen.hk/pay/xxx

处理 Webhook

from flask import Flask, request, jsonify
import newgen

app = Flask(__name__)

@app.route("/webhook", methods=["POST"])
def handle_webhook():
    event = client.webhooks.construct_event(
        request.data,
        request.headers["Newgen-Signature"]
    )
    
    if event.type == "payment.succeeded":
        # 处理支付成功
        payment = event.data.object
        print(f"Payment received: {payment.amount}")
    
    return jsonify({"status": "success"})

多语言 SDK 支持

🐍

Python

🟢

Node.js

🔷

Go

Java

需要帮助?

我们的技术团队随时为您服务

联系技术支持 →