Django对接支付宝沙箱环境（2024年9月新测有效）

目录

1. 引言
2. 支付宝接口概述
3. 环境准备
   • 3.1 创建Django项目
   • 3.2 安装依赖库
4. 支付宝沙箱环境介绍
   • 4.1 获取开发者账号
   • 4.2 创建应用并获取密钥
5. Django配置
   • 5.1 配置settings.py
   • 5.2 配置URLs
6. 实现支付宝支付功能
   • 6.1 生成订单
   • 6.2 异步通知处理
7. 测试支付流程
   • 7.1 使用沙箱环境进行测试
8. 常见问题及解决方案
9. 总结

引言

随着电子支付的普及，支付宝作为国内主要的支付平台之一，其API接口在各类应用中得到了广泛应用。本文将详细介绍如何在Django项目中对接支付宝的沙箱环境，包括环境准备、配置、实现支付功能以及测试流程等内容，以帮助开发者快速上手。

支付宝接口概述

支付宝提供了一系列的API接口，支持商户进行在线支付、退款、查询等操作。在实际的开发过程中，建议先使用沙箱环境进行调试和测试，确保系统的稳定性和准确性。

环境准备

创建Django项目

首先，我们需要创建一个新的Django项目：

bashCopy Code
django-admin startproject alipay_demo
cd alipay_demo

安装依赖库

我们将使用requests库来发送HTTP请求，因此需要安装它：

bashCopy Code
pip install requests

支付宝沙箱环境介绍

获取开发者账号

访问支付宝开放平台并注册一个开发者账号。完成注册后，登录到开发者后台。

创建应用并获取密钥

1. 在开发者后台创建一个新的应用。
2. 填写应用信息，并选择沙箱环境。
3. 完成后，可以获取到APPID、应用公钥、支付宝公钥等信息，这些将在后续代码中使用。

Django配置

配置settings.py

在settings.py中添加支付宝相关的配置信息：

pythonCopy Code
ALIPAY_APP_ID = 'your_app_id'
ALIPAY_APP_PRIVATE_KEY = 'your_app_private_key'
ALIPAY_PUBLIC_KEY = 'your_alipay_public_key'
ALIPAY_SANDBOX_URL = 'https://openapi.alipaydev.com/gateway.do'

配置URLs

在urls.py中添加相应的URL路由：

pythonCopy Code
from django.urls import path
from . import views

urlpatterns = [
    path('alipay/create_order/', views.create_order, name='create_order'),
    path('alipay/notify/', views.notify, name='notify'),
]

实现支付宝支付功能

生成订单

以下是生成订单的视图函数：

pythonCopy Code
import json
import time
import uuid
from django.http import JsonResponse
from django.views.decorators.csrf import csrf_exempt
from django.conf import settings
from alipay import Alipay

@csrf_exempt
def create_order(request):
    alipay = Alipay(
        appid=settings.ALIPAY_APP_ID,
        app_private_key_string=settings.ALIPAY_APP_PRIVATE_KEY,
        alipay_public_key_string=settings.ALIPAY_PUBLIC_KEY,
        sign_type='RSA2',
        debug=True,  # False for production
    )

    order_id = str(uuid.uuid4())
    subject = "Test Order"
    total_amount = "0.01"  # Amount in yuan

    order_string = alipay.api_alipay_trade_page_pay(
        out_trade_no=order_id,
        total_amount=total_amount,
        subject=subject,
        return_url='http://localhost:8000/alipay/return/',
        notify_url='http://localhost:8000/alipay/notify/',  # Optional
    )

    pay_url = f"https://openapi.alipaydev.com/gateway.do?{order_string}"
    return JsonResponse({"pay_url": pay_url})

异步通知处理

支付宝会在用户支付完成后向我们指定的notify_url发送异步通知，以下是处理异步通知的逻辑：

pythonCopy Code
@csrf_exempt
def notify(request):
    data = request.POST
    alipay = Alipay(
        appid=settings.ALIPAY_APP_ID,
        app_private_key_string=settings.ALIPAY_APP_PRIVATE_KEY,
        alipay_public_key_string=settings.ALIPAY_PUBLIC_KEY,
        sign_type='RSA2',
    )

    # 验证签名
    signature = data.get('sign')
    success = alipay.verify(data, signature)
    
    if success:
        # 处理订单
        print("Payment success!")
        # 更新数据库状态等
        return JsonResponse({"code": "success"})
    else:
        return JsonResponse({"code": "failure"})

测试支付流程

使用沙箱环境进行测试

1. 启动Django服务器:

bashCopy Code
python manage.py runserver

2. 访问http://localhost:8000/alipay/create_order/，会返回一个支付链接。
3. 点击链接，按照提示完成支付。
4. 检查控制台输出以确认支付是否成功。

常见问题及解决方案

问题1：签名验证失败

解决方案：检查appid、app_private_key和alipay_public_key是否正确，并确保使用的是RSA2签名方式。

问题2：无法连接沙箱环境

解决方案：检查网络连接是否正常，并确保使用的沙箱URL正确。

问题3：订单状态未更新

解决方案：确认异步通知URL是否能被支付宝访问，必要时查看Django的日志输出。

总结

本文详细介绍了如何在Django项目中对接支付宝的沙箱环境，包括环境的搭建、配置、支付功能的实现以及测试流程。通过这些步骤，开发者可以快速实现支付宝支付功能，并在实际项目中进行应用。

希望本文能帮助到你，祝你在开发过程中顺利！如果有任何问题，欢迎留言讨论。