IRONSOFTWAREHOME
ATUALIZAÇÕES DO DESENVOLVEDOR

Integração do Stripe .NET com o IronPDF

Curtis Chau
Curtis Chau
Updated: 21 de abril de 2026

Stripe.Net é uma poderosa biblioteca .NET que permite aos desenvolvedores integrar as capacidades de processamento de pagamentos do Stripe em aplicações .NET. Stripe é um gateway de pagamento popular que permite às empresas aceitar pagamentos online. Com Stripe.Net, os desenvolvedores podem gerenciar transações, clientes, assinaturas e mais usando os recursos robustos fornecidos pela API do Stripe. Neste artigo, discutiremos como usar o Stripe com o IronPDF para criar PDFs.

Primeiros passos com o Stripe .NET

Criar um novo projeto do Visual Studio

Para começar com Stripe.Net, precisamos criar um novo projeto no Visual Studio ou abrir um já existente. Para este tutorial, usaremos um projeto de Aplicativo de Console.

  1. Abra o Visual Studio e clique em "Criar um novo projeto".

    Stripe .NET (How It Works For Developers): Figure 1 - Open Visual Studio and click on "Create a new project" option.

  2. Uma nova janela será aberta. Selecione Aplicativo de Console e clique em Avançar.

    Stripe .NET (Como funciona para desenvolvedores): Figura 2 - Selecione Aplicativo de console C# como o tipo de projeto. Clique em Avançar.

  3. Na janela seguinte, insira o nome do seu projeto e selecione o local, depois clique em Avançar.

    Stripe .NET (Como funciona para desenvolvedores): Figura 3 - Configure seu projeto especificando o nome do projeto, o local e o nome da solução. Em seguida, clique em Avançar.

  4. Na janela seguinte, selecione a estrutura e clique em Criar.

    Stripe .NET (Como Funciona Para Desenvolvedores): Figura 4 - Selecione o .NET Framework apropriado para o seu projeto e clique em Criar.

Assim, de repente, seu novo projeto de Aplicativo de Console do Visual Studio é criado.

Instalação

Para começar a usar Stripe.Net em seu projeto, você precisa instalar o pacote Stripe.Net via NuGet. Você pode fazer isso usando o Console do Gerenciador de Pacotes ou o Gerenciador de Pacotes NuGet no Visual Studio.

Utilizando o Console do Gerenciador de Pacotes:

PM > Install-Package Stripe.net

Ou

dotnet add package Stripe.net

Utilizando o gerenciador de pacotes NuGet , procure por "Stripe .NET" e instale o pacote.

Configuração

Após a instalação, você precisa configurar sua chave de API do Stripe, que pode ser encontrada na sua conta do Stripe. Essa chave é essencial para autenticar suas solicitações à API do Stripe. Normalmente, essa chave é armazenada em um arquivo de configuração ou variável de ambiente por motivos de segurança.

Aqui está um exemplo de como configurar sua chave de API:

StripeConfiguration.ApiKey = "your_secret_api_key";

Operações básicas com Stripe .NET

Criando um Cliente

Criar um cliente é uma das operações fundamentais ao trabalhar com Stripe.Net. Os clientes podem ser associados a métodos de pagamento e assinaturas.

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

Painel de controle do Stripe

Stripe .NET (Como Funciona Para Desenvolvedores): Figura 5 - Painel do Stripe para Clientes

Criando uma intenção de pagamento

Um PaymentIntent é um objeto que representa um processo de pagamento no Stripe. Ele é projetado para rastrear o ciclo de vida de um pagamento desde a criação até a conclusão.

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

Stripe .NET (Como Funciona Para Desenvolvedores): Figura 6 - Intenção de Pagamento no Stripe

Recursos avançados

Assinaturas

O Stripe suporta vários modelos de assinatura, e gerenciar assinaturas via Stripe.Net é direto. Você pode criar, atualizar e cancelar assinaturas.

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);

Stripe .NET (Como Funciona Para Desenvolvedores): Figura 7 - Serviço de Assinatura do Stripe

Gestão de Conflitos

Disputas ocorrem quando um cliente questiona uma cobrança junto ao seu banco ou à sua operadora de cartão de crédito. Stripe.Net permite listar, recuperar e responder a disputas.

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

Melhores práticas

  1. Segurança: Sempre proteja suas chaves de API e nunca as codifique diretamente nos seus arquivos de código-fonte.
  2. Tratamento de erros: Implemente um tratamento de erros robusto para gerenciar exceções e chamadas de API com falha.
  3. Teste: Utilize o modo de teste do Stripe e forneça números de cartão de teste para testar completamente a sua integração.
  4. Documentação: Consulte a documentação oficial da API do Stripe e a documentação da biblioteca Stripe.Net para obter informações e exemplos atualizados.

Introducing IronPDF for C#

Stripe .NET (Como Funciona Para Desenvolvedores): Figura 8 - IronPDF for .NET: A Biblioteca de PDF do C#

IronPDF é uma biblioteca C# que permite aos desenvolvedores criar, editar e extrair conteúdo de documentos PDF. É uma ferramenta ideal para gerar PDFs em aplicações .NET , seja para relatórios, faturas ou outras necessidades de documentação.

O IronPDF consegue converter com precisão páginas da web, URLs e HTML para o formato PDF , tornando-se uma ferramenta perfeita para criar documentos PDF a partir de conteúdo online, como relatórios e faturas.

using IronPdf;

class Program
{
    static void Main(string[] args)
    {
        var renderer = new ChromePdfRenderer();

        // 1. Convert HTML String to PDF
        var htmlContent = "<h1>Hello, IronPDF!</h1><p>This is a PDF from an HTML string.</p>";
        var pdfFromHtmlString = renderer.RenderHtmlAsPdf(htmlContent);
        pdfFromHtmlString.SaveAs("HTMLStringToPDF.pdf");

        // 2. Convert HTML File to PDF
        var htmlFilePath = "path_to_your_html_file.html"; // Specify the path to your HTML file
        var pdfFromHtmlFile = renderer.RenderHtmlFileAsPdf(htmlFilePath);
        pdfFromHtmlFile.SaveAs("HTMLFileToPDF.pdf");

        // 3. Convert URL to PDF
        var url = "http://ironpdf.com"; // Specify the URL
        var pdfFromUrl = renderer.RenderUrlAsPdf(url);
        pdfFromUrl.SaveAs("URLToPDF.pdf");
    }
}

Principais características

1. HTML para PDF

O IronPDF permite que desenvolvedores criem documentos PDF facilmente, convertendo strings HTML, URLs e arquivos HTML em PDF.

2. Edição de PDF

Edite documentos PDF existentes com facilidade. O IronPDF permite manipular PDFs existentes, possibilitando aos usuários adicionar páginas em índices específicos, copiar ou excluir páginas, dividir um PDF e extrair páginas para criar novos PDFs, etc.

3. Fusão de PDFs

A funcionalidade de mesclagem do IronPDF permite que os desenvolvedores combinem dois ou mais documentos PDF em um só.

4. Segurança do PDF

O IronPDF permite que os usuários adicionem senhas e permissões a PDFs para aumentar a segurança dos mesmos.

5. Criptografia e descriptografia de PDF

O IronPDF suporta criptografia de 128 bits, descriptografia e proteção por senha de documentos PDF.

6. Assinar digitalmente um documento PDF

Os desenvolvedores podem adicionar assinaturas digitais a PDFs de forma programática usando o IronPDF. Suporta várias maneiras de assinar um PDF com um certificado de assinatura digital dos formatos .pfx e .p12.

Exemplo: Gerando uma fatura em PDF com Stripe .NET e IronPDF

Vamos criar um exemplo prático onde geramos uma fatura em PDF usando o IronPDF após processar um pagamento com Stripe.Net.

Instale a biblioteca IronPDF .NET.

Passos para instalar o IronPDF usando o Gerenciador de Pacotes NuGet :

  1. Abra seu projeto ASP.NET no Visual Studio e navegue até o menu "Ferramentas".

  2. Selecione "Gerenciador de Pacotes NuGet " e clique em "Gerenciar Pacotes NuGet para a Solução".

  3. Na aba "Procurar", pesquise por "IronPDF" e selecione a versão desejada. Clique em "Instalar" para adicionar o pacote ao seu projeto. O IronPDF e suas dependências serão baixados e integrados automaticamente, permitindo que você comece a aproveitar suas funcionalidades em sua aplicação ASP.NET sem problemas.

    Stripe .NET (How It Works For Developers): Figure 9 - Install IronPDF using the Manage NuGet Package for Solution by searching "IronPDF" in the search bar of NuGet Package Manager, then select the project and click on the Install button.

Processar pagamento e gerar fatura

Aqui está um exemplo completo que demonstra a criação de um novo pagamento com a API Stripe.Net e a geração de uma fatura em PDF com IronPDF.

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();
    }
}

Saída

Stripe .NET (Como Funciona Para Desenvolvedores): Figura 10 - Fatura em PDF gerada usando o IronPDF via Serviço do Stripe

Conclusão

Stripe.Net é uma biblioteca abrangente e poderosa que simplifica a integração do processamento de pagamentos do Stripe em aplicações .NET. Com funcionalidades que vão desde o processamento básico de transações até a gestão de assinaturas e disputas, abrange uma ampla gama de necessidades relacionadas a pagamentos.

IronPDF complementa Stripe.Net ao permitir que os desenvolvedores gerem, editem e gerenciem documentos PDF. Em conjunto, essas bibliotecas fornecem uma solução robusta para lidar com pagamentos e gerar a documentação correspondente em aplicações .NET .

Aproveitando as capacidades de Stripe.Net e IronPDF, os desenvolvedores podem criar fluxos de trabalho contínuos e eficientes que lidam com tudo, desde o processamento de pagamentos até a geração de documentos, melhorando a funcionalidade geral e a experiência do usuário de suas aplicações.

O IronPDF oferece aos desenvolvedores a oportunidade de testar seus diversos recursos, fornecendo um período de IronPDF gratuito .

O IronPDF oferece suporte ao cliente e atualizações, juntamente com exemplos de código e documentação completa para ajudar os usuários a tirar o máximo proveito da ferramenta. Para explorar o assunto mais a fundo, consulte nosso tutorial completo sobre conversão de HTML para PDF com o IronPDF .

Curtis Chau
Redator Técnico

Curtis Chau é bacharel em Ciência da Computação (Universidade Carleton) e se especializa em desenvolvimento front-end, com experiência em Node.js, TypeScript, JavaScript e React. Apaixonado por criar interfaces de usuário intuitivas e esteticamente agradáveis, Curtis gosta de trabalhar com frameworks modernos e criar manuais bem estruturados e visualmente atraentes.

...
Leia mais

Artigos relacionados

Key in blue circle

Obtenha sua chave de avaliação gratuita de 30 dias instantaneamente.

Your trial license will be sent to your email address

Sem limitações. 100% desbloqueado. Sem cartão de crédito.

bullet_checkedNão é necessário cartão de crédito nem criação de conta.Sem limitações. 100% desbloqueado. Sem cartão de crédito.
  • Logo Aetna
  • Logo NASA
  • Logo GE
  • Logo Porsche
  • Logo USDA
  • Logo Qatar
Join Millions of Engineers who’ve tried IronPDF
Agende sua demonstração ao vivo gratuita.
Booking Badge

Aprovado por milhões de engenheiros em todo o mundo.

Logotipos dos clientes da Iron Software
Agende sua consulta sem compromisso.
Preencha o formulário abaixo ou envie um e-mail para sales@ironsoftware.com
Os seus dados serão sempre mantidos em sigilo.
Aprovado por milhões de engenheiros em todo o mundo.
Logotipos dos clientes da Iron Software
Obtenha sua chave de avaliação gratuita de 30 dias instantaneamente.
Não é necessário cartão de crédito nem criação de conta.