在开发支付接口API时，通常需要与支付网关进行集成，以便实现支付、查询支付状态以及处理退款等功能。Python 提供了多种方式来调用这些API，包括使用第三方库（如 `requests`）来发送 HTTP 请求。以下是一个完整的开发指南，涵盖如何使用 Python 编写支付接口的 API 调用逻辑。 ### 3.1 初始化支付请求 支付请求通常通过 `POST` 请求发送到支付网关的指定端点。以下是一个使用 `requests` 库发起支付请求的示例： ```python import requests import json def initiate_payment(amount, currency, customer_email): url = "https://api.paymentgateway.com/api/payments" headers = { "Content-Type": "application/json", "Authorization": "Bearer YOUR_API_KEY" } payload = { "amount": amount, "currency": currency, "customer_email": customer_email } response = requests.post(url, headers=headers, data=json.dumps(payload)) return response.json() ``` 该函数通过向 `/api/payments` 端点发送 `POST` 请求来发起支付请求[^2]。 ### 3.2 查询支付状态 支付完成后，可以通过支付 ID 查询交易状态。以下是一个查询支付状态的函数示例： ```python def get_payment_status(payment_id): url = f"https://api.paymentgateway.com/api/payments/{payment_id}" headers = { "Authorization": "Bearer YOUR_API_KEY" } response = requests.get(url, headers=headers) return response.json() ``` 该函数使用 `GET` 请求访问 `/api/payments/{payment_id}` 接口以获取支付状态[^2]。 ### 3.3 处理退款请求 退款请求通常也是通过 `POST` 请求发送到特定的退款端点。以下是一个处理单笔退款的示例： ```python def process_refund(payment_id, amount): url = f"https://api.paymentgateway.com/api/payments/{payment_id}/refund" headers = { "Content-Type": "application/json", "Authorization": "Bearer YOUR_API_KEY" } payload = { "amount": amount } response = requests.post(url, headers=headers, data=json.dumps(payload)) return response.json() ``` 该函数调用 `/api/payments/{payment_id}/refund` 接口来处理退款请求。 ### 3.4 批量退款接口 在需要处理大量退款的情况下，可以使用批量退款接口。以下是一个示例函数，用于发起批量退款请求： ```python def batch_refund(refund_requests): url = "https://api.paymentgateway.com/api/refunds/batch" headers = { "Content-Type": "application/json", "Authorization": "Bearer YOUR_API_KEY" } payload = { "refunds": refund_requests # 一个包含多个退款请求的列表 } response = requests.post(url, headers=headers, data=json.dumps(payload)) return response.json() ``` 该接口适用于需要快速处理大量退款请求的场景，例如电商平台的促销活动后或退票服务中[^3]。 ### 3.5 处理速率限制 在调用支付网关 API 时，需要注意速率限制问题。某些网关会根据请求中的 `max_tokens` 参数来计算速率限制。如果请求中没有包含 `max_tokens`，则会使用默认值进行计算。此外，速率限制的判断基于请求的 token 数量加上 `max_tokens` 的数量，而不是实际生成的 token 数量[^4]。 为了避免超出速率限制，可以在代码中加入重试机制或在请求之间添加延迟： ```python import time def safe_api_call(func, retries=3, delay=2): for i in range(retries): try: return func() except Exception as e: if i < retries - 1: time.sleep(delay) else: raise e ``` ### 3.6 安全性与认证 支付 API 通常需要使用 API 密钥或其他形式的身份验证。在代码中应避免将密钥硬编码在源代码中，可以使用环境变量或配置文件来管理敏感信息： ```python import os api_key = os.getenv("PAYMENT_GATEWAY_API_KEY") ``` ### 3.7 异常处理与日志记录 在实际应用中，建议添加详细的异常处理和日志记录功能，以便在发生错误时能够快速定位问题： ```python import logging logging.basicConfig(level=logging.INFO) def log_api_call(response): logging.info(f"API Response Status: {response.status_code}") logging.debug(f"Response Body: {response.text}") ``` ###