Munewwer.LakalaPay.Core 0.25.4101

Munewwer.LakalaPay

简介

Munewwer.LakalaPay 是一个基于 .NET Standard 2.1 的拉卡拉支付 SDK，提供了对拉卡拉支付接口的完整封装，使开发者能够轻松集成拉卡拉支付功能到自己的应用中。

特性

• 支持多种支付方式：主扫、被扫、合单支付等
• 提供完整的交易功能：预下单、支付、查询、关单、撤销、退款等
• 支持全报文加密模式
• 支持主流支付渠道：微信、支付宝、银联等
• 使用依赖注入模式，易于集成
• 完善的类型定义和注释

安装

dotnet add package Munewwer.LakalaPay.Core
dotnet add package Munewwer.LakalaPay.Payments

快速开始

1. 配置服务

在 Startup.cs 或 Program.cs 中配置服务：

services.ConfigureLakalaPay(options =>
{
    options.AppId = "你的AppId";
    options.SerialNo = "证书序列号";
    options.Sm4Key = "国密4密钥";
    options.PlatformId = "平台ID";
    options.BindOrgCode = "绑定的机构编号";
    
    // 导入证书
    options.ImportPublicKey("公钥证书路径");
    options.ImportPrivateKey("私钥证书路径", "证书密码");
});

2. 使用服务

public class PaymentService
{
    private readonly ILakalaPayService _lakalaPayService;

    public PaymentService(ILakalaPayService lakalaPayService)
    {
        _lakalaPayService = lakalaPayService;
    }

    // 创建预订单（主扫模式）
    public async Task<string> CreatePreOrderAsync(string orderId, decimal amount, string subject)
    {
        var request = new LakalaPreOrderRequest
        {
            MerchantOrderId = orderId,
            Amount = (long)(amount * 100), // 转换为分
            Subject = subject,
            PayType = LakalaCardType.WechatPay, // 设置支付方式：微信支付
            NotifyUrl = "https://your-domain.com/notify"
        };
        
        var result = await _lakalaPayService.CreatePreOrderAsync(request);
        
        if (result.IsSuccess)
        {
            return result.Data.QrCodeUrl; // 返回二维码链接
        }
        
        throw new Exception($"创建预订单失败：{result.ReturnMsg}");
    }
    
    // 查询订单
    public async Task<LakalaQueryOrderResult> QueryOrderAsync(string orderId)
    {
        var request = new LakalaQueryOrderRequest
        {
            MerchantOrderId = orderId
        };
        
        var result = await _lakalaPayService.GetTradeQueryAsync(request);
        
        if (result.IsSuccess)
        {
            return result.Data;
        }
        
        throw new Exception($"查询订单失败：{result.ReturnMsg}");
    }
}

支持的支付方式

主扫支付（顾客扫商家）

// 创建预订单
var result = await _lakalaPayService.CreatePreOrderAsync(request);

// 加密模式
var result = await _lakalaPayService.CreateEncryptedPreOrderAsync(request);

被扫支付（商家扫顾客）

// 付款码支付
var result = await _lakalaPayService.CreateMicropayAsync(request);

// 加密模式
var result = await _lakalaPayService.CreateEncryptedMicropayAsync(request);

合单支付

// 主扫合单
var result = await _lakalaPayService.CreateMergePreOrderAsync(request);

// 被扫合单
var result = await _lakalaPayService.CreateMergeMicropayAsync(request);

其他操作

交易查询

var result = await _lakalaPayService.GetTradeQueryAsync(request);

关闭订单

var result = await _lakalaPayService.CloseTradeOrderAsync(request);

撤销交易

var result = await _lakalaPayService.RevokeTradeOrderAsync(request);

退款

// 普通退款
var result = await _lakalaPayService.RefundTradeOrderAsync(request);

// 合单退款
var result = await _lakalaPayService.RefundMergeTradeOrderAsync(request);

高级配置

切换环境

// 测试环境
LakalaPayServiceExtensions.Host = "https://test.wsmsd.cn/sit/api/v3/";

// 生产环境
LakalaPayServiceExtensions.Host = "https://s2.lakala.com/api/v3/";

自定义 HTTP 客户端

services.ConfigureLakalaPay(
    configureOptions: options => { /* 配置选项 */ },
    configureClient: client => 
    {
        client.Timeout = TimeSpan.FromSeconds(30);
        // 其他 HTTP 客户端配置
    }
);

支持与贡献

如果您发现任何问题或有改进建议，请提交 Issue 或 Pull Request。

许可证

MIT