Tworzenie nowego projektu w Visual Studio

Aby rozpocząć pracę z Stripe.Net, należy utworzyć nowy projekt w Visual Studio lub otworzyć istniejący. W tym samouczku wykorzystamy projekt aplikacji konsolowej.

1. Otwórz Visual Studio i kliknij opcję „Utwórz nowy projekt".

   

2. Pojawi się nowe okno. Wybierz opcję Aplikacja konsolowa i kliknij Dalej.

   

3. W kolejnym oknie wprowadź nazwę projektu i wybierz lokalizację, a następnie kliknij Dalej.

   

4. W kolejnym oknie wybierz framework i kliknij Utwórz.

   

W ten sposób tworzony jest nowy projekt aplikacji konsolowej Visual Studio.

Instalacja

To start using Stripe.Net in your project, you need to install the Stripe.Net package via NuGet. Można to zrobić za pomocą konsoli menedżera pakietów lub menedżera pakietów NuGet w programie Visual Studio.

Korzystanie z konsoli menedżera pakietów:

Install-Package Stripe.net

Lub

dotnet add package Stripe.net

Za pomocą menedżera pakietów NuGet wyszukaj "Stripe.net" i zainstaluj pakiet.

Konfiguracja

Po zainstalowaniu należy skonfigurować klucz API Stripe, który można znaleźć na koncie Stripe. Ten klucz jest niezbędny do uwierzytelniania żądań kierowanych do API Stripe. Zazwyczaj klucz ten jest przechowywany w pliku konfiguracyjnym lub zmiennej środowiskowej ze względów bezpieczeństwa.

Oto przykład konfiguracji klucza API:

StripeConfiguration.ApiKey = "your_secret_api_key";

StripeConfiguration.ApiKey = "your_secret_api_key";

StripeConfiguration.ApiKey = "your_secret_api_key"

Tworzenie klienta

var options = new CustomerCreateOptions
{
    Email = "customer@example.com",
    Name = "John Doe",
};
var service = new CustomerService();
Customer customer = service.Create(options);

var options = new CustomerCreateOptions
{
    Email = "customer@example.com",
    Name = "John Doe",
};
var service = new CustomerService();
Customer customer = service.Create(options);

Dim options = New CustomerCreateOptions With {
	.Email = "customer@example.com",
	.Name = "John Doe"
}
Dim service = New CustomerService()
Dim customer As Customer = service.Create(options)

Tworzenie intencji płatności

PaymentIntent to obiekt reprezentujący proces płatności w Stripe. Służy do śledzenia cyklu życia płatności — od jej utworzenia aż do zakończenia.

var options = new PaymentIntentCreateOptions
{
    Amount = 2000,
    Currency = "usd",
    PaymentMethodTypes = new List<string>
    {
        "card",
    },
};
var service = new PaymentIntentService();
PaymentIntent paymentIntent = service.Create(options);

var options = new PaymentIntentCreateOptions
{
    Amount = 2000,
    Currency = "usd",
    PaymentMethodTypes = new List<string>
    {
        "card",
    },
};
var service = new PaymentIntentService();
PaymentIntent paymentIntent = service.Create(options);

Dim options = New PaymentIntentCreateOptions With {
	.Amount = 2000,
	.Currency = "usd",
	.PaymentMethodTypes = New List(Of String) From {"card"}
}
Dim service = New PaymentIntentService()
Dim paymentIntent As PaymentIntent = service.Create(options)

Subskrypcje

Stripe obsługuje różne modele subskrypcji, a zarządzanie nimi za pośrednictwem Stripe.Net jest proste. Możliwe jest tworzenie, aktualizowanie i anulowanie subskrypcji.

var options = new SubscriptionCreateOptions
{
    Customer = "cus_123456789",
    Items = new List<SubscriptionItemOptions>
    {
        new SubscriptionItemOptions
        {
            Plan = "plan_123456789",
        },
    },
};
var service = new SubscriptionService();
Subscription subscription = service.Create(options);

var options = new SubscriptionCreateOptions
{
    Customer = "cus_123456789",
    Items = new List<SubscriptionItemOptions>
    {
        new SubscriptionItemOptions
        {
            Plan = "plan_123456789",
        },
    },
};
var service = new SubscriptionService();
Subscription subscription = service.Create(options);

Dim options = New SubscriptionCreateOptions With {
	.Customer = "cus_123456789",
	.Items = New List(Of SubscriptionItemOptions) From {
		New SubscriptionItemOptions With {.Plan = "plan_123456789"}
	}
}
Dim service = New SubscriptionService()
Dim subscription As Subscription = service.Create(options)

Rozstrzyganie sporów

Spory mają miejsce, gdy klient kwestionuje opłatę w swoim banku lub firmie obsługującej kartę kredytową. Stripe.Net umożliwia wyświetlanie listy sporów, pobieranie ich danych oraz udzielanie odpowiedzi.

var service = new DisputeService();
Dispute dispute = service.Get("dp_123456789");

var service = new DisputeService();
Dispute dispute = service.Get("dp_123456789");

Dim service = New DisputeService()
Dim dispute As Dispute = service.Get("dp_123456789")

Najlepsze praktyki

1. Bezpieczeństwo: Zawsze zabezpieczaj swoje klucze API i nigdy nie zapisuj ich na stałe w plikach źródłowych.
2. Obsługa błędów: Wprowadź solidną obsługę błędów w celu zarządzania wyjątkami i nieudanymi wywołaniami API.
3. Testowanie: Skorzystaj z trybu testowego Stripe i podaj numery kart testowych, aby dokładnie przetestować integrację.
4. Dokumentacja: W celu uzyskania aktualnych informacji i przykładów należy korzystać z oficjalnej dokumentacji API Stripe oraz dokumentacji biblioteki Stripe.Net.

Najważniejsze cechy

Zainstaluj bibliotekę IronPDF .NET

Kroki instalacji IronPDF przy użyciu menedżera pakietów NuGet:

1. Otwórz projekt ASP.NET w programie Visual Studio i przejdź do menu "Narzędzia".
2. Wybierz "NuGet Package Manager", a następnie kliknij "Manage NuGet Packages for Solution".

3. W zakładce "Przeglądaj" wyszukaj "IronPDF" i wybierz żądaną wersję. Kliknij "Zainstaluj", aby dodać pakiet do swojego projektu. IronPDF i jego zależności zostaną automatycznie pobrane i zintegrowane, co pozwoli na płynne wykorzystanie jego funkcjonalności w aplikacji ASP.NET.

   

Przetwarzanie płatności i generowanie faktur

using Stripe;
using IronPdf;
using System;
using System.Collections.Generic;

public class PaymentService
{
    public void ProcessPaymentAndGenerateInvoice()
    {
        // Configure Stripe API key
        StripeConfiguration.ApiKey = "your_secret_key";

        // Create a PaymentIntent
        var paymentIntentOptions = new PaymentIntentCreateOptions
        {
            Amount = 2000, // Amount in cents
            Currency = "usd",
            PaymentMethodTypes = new List<string> { "card" },
        };
        var paymentIntentService = new PaymentIntentService();
        PaymentIntent paymentIntent = paymentIntentService.Create(paymentIntentOptions);

        // Assuming payment succeeded, create a PDF invoice
        GeneratePdfInvoice(paymentIntent);
    }

    private void GeneratePdfInvoice(PaymentIntent paymentIntent)
    {
        // Create HTML content for the invoice
        var htmlContent = $@"
        <html>
        <head>
            <title>Invoice</title>
        </head>
        <body>
            <h1>Invoice</h1>
            <p>Payment ID: {paymentIntent.Id}</p>
            <p>Amount: {paymentIntent.Amount / 100.0:C}</p>
            <p>Status: {paymentIntent.Status}</p>
        </body>
        </html>";

        // Convert the HTML content to a PDF document
        var renderer = new ChromePdfRenderer();
        var pdfDocument = renderer.RenderHtmlAsPdf(htmlContent);

        // Save the PDF document to a file
        var filePath = "invoice.pdf";
        pdfDocument.SaveAs(filePath);
        Console.WriteLine($"Invoice saved to {filePath}");
    }
}

class Program
{
    static void Main(string[] args)
    {
        var service = new PaymentService();
        service.ProcessPaymentAndGenerateInvoice();
    }
}

using Stripe;
using IronPdf;
using System;
using System.Collections.Generic;

public class PaymentService
{
    public void ProcessPaymentAndGenerateInvoice()
    {
        // Configure Stripe API key
        StripeConfiguration.ApiKey = "your_secret_key";

        // Create a PaymentIntent
        var paymentIntentOptions = new PaymentIntentCreateOptions
        {
            Amount = 2000, // Amount in cents
            Currency = "usd",
            PaymentMethodTypes = new List<string> { "card" },
        };
        var paymentIntentService = new PaymentIntentService();
        PaymentIntent paymentIntent = paymentIntentService.Create(paymentIntentOptions);

        // Assuming payment succeeded, create a PDF invoice
        GeneratePdfInvoice(paymentIntent);
    }

    private void GeneratePdfInvoice(PaymentIntent paymentIntent)
    {
        // Create HTML content for the invoice
        var htmlContent = $@"
        <html>
        <head>
            <title>Invoice</title>
        </head>
        <body>
            <h1>Invoice</h1>
            <p>Payment ID: {paymentIntent.Id}</p>
            <p>Amount: {paymentIntent.Amount / 100.0:C}</p>
            <p>Status: {paymentIntent.Status}</p>
        </body>
        </html>";

        // Convert the HTML content to a PDF document
        var renderer = new ChromePdfRenderer();
        var pdfDocument = renderer.RenderHtmlAsPdf(htmlContent);

        // Save the PDF document to a file
        var filePath = "invoice.pdf";
        pdfDocument.SaveAs(filePath);
        Console.WriteLine($"Invoice saved to {filePath}");
    }
}

class Program
{
    static void Main(string[] args)
    {
        var service = new PaymentService();
        service.ProcessPaymentAndGenerateInvoice();
    }
}

Imports Stripe
Imports IronPdf
Imports System
Imports System.Collections.Generic

Public Class PaymentService
	Public Sub ProcessPaymentAndGenerateInvoice()
		' Configure Stripe API key
		StripeConfiguration.ApiKey = "your_secret_key"

		' Create a PaymentIntent
		Dim paymentIntentOptions = New PaymentIntentCreateOptions With {
			.Amount = 2000,
			.Currency = "usd",
			.PaymentMethodTypes = New List(Of String) From {"card"}
		}
		Dim paymentIntentService As New PaymentIntentService()
		Dim paymentIntent As PaymentIntent = paymentIntentService.Create(paymentIntentOptions)

		' Assuming payment succeeded, create a PDF invoice
		GeneratePdfInvoice(paymentIntent)
	End Sub

	Private Sub GeneratePdfInvoice(ByVal paymentIntent As PaymentIntent)
		' Create HTML content for the invoice
'INSTANT VB WARNING: Instant VB cannot determine whether both operands of this division are integer types - if they are then you should use the VB integer division operator:
		Dim htmlContent = $"
        <html>
        <head>
            <title>Invoice</title>
        </head>
        <body>
            <h1>Invoice</h1>
            <p>Payment ID: {paymentIntent.Id}</p>
            <p>Amount: {paymentIntent.Amount / 100.0:C}</p>
            <p>Status: {paymentIntent.Status}</p>
        </body>
        </html>"

		' Convert the HTML content to a PDF document
		Dim renderer = New ChromePdfRenderer()
		Dim pdfDocument = renderer.RenderHtmlAsPdf(htmlContent)

		' Save the PDF document to a file
		Dim filePath = "invoice.pdf"
		pdfDocument.SaveAs(filePath)
		Console.WriteLine($"Invoice saved to {filePath}")
	End Sub
End Class

Friend Class Program
	Shared Sub Main(ByVal args() As String)
		Dim service = New PaymentService()
		service.ProcessPaymentAndGenerateInvoice()
	End Sub
End Class

Wnioski

Stripe.Net to kompleksowa i wydajna biblioteka upraszczająca integrację płatności Stripe w aplikacjach .NET. Dzięki funkcjom obejmującym zarówno podstawową obsługę transakcji, jak i zarządzanie subskrypcjami oraz sporami, rozwiązanie to zaspokaja szeroki zakres potrzeb związanych z płatnościami.

IronPDF uzupełnia Stripe.Net, umożliwiając programistom generowanie, edytowanie i zarządzanie dokumentami PDF. W połączeniu biblioteki te stanowią solidne rozwiązanie do obsługi płatności i generowania odpowiedniej dokumentacji w aplikacjach .NET.

Wykorzystując możliwości zarówno Stripe.Net, jak i IronPDF, można tworzyć wydajne procesy obejmujące wszystko — od przetwarzania płatności po generowanie dokumentów — co zwiększa ogólną funkcjonalność i wygodę korzystania z aplikacji.

IronPDF oferuje programistom możliwość przetestowania swoich rozbudowanych funkcji, udostępniając bezpłatną wersję próbną IronPDF.

IronPDF zapewnia obsługę klienta i aktualizacje, a także przykłady kodu i obszerną dokumentację, aby pomóc użytkownikom w jak najlepszym wykorzystaniu produktu. Aby zgłębić ten temat, zapoznaj się z naszym obszernym samouczkiem dotyczącym konwersji HTML do PDF za pomocą IronPDF.