Pular para o conteúdo
Criar conta ou Entrar
O logotipo da documentação da Stripe
/
Criar contaLogin
Visão geralAceitar um pagamentoAtualize sua integração
Pagamentos online
Visão geralEncontre seu caso de usoUsar o Managed PaymentsPagamentos recorrentes
Pagamentos presenciais
Formas de pagamento
Adicionar formas de pagamento
Operações de pagamento
Saldos e tempo de liquidaçãoRecibosReembolsos e cancelamentos
Integrações avançadas
Muito mais que pagamentos

Accept a PayPal payment

Learn how to accept PayPal payment, a digital wallet popular with businesses in Europe.

Cuidado

A Stripe pode apresentar automaticamente as formas de pagamento relevantes aos seus clientes avaliando moedas, restrições de formas de pagamento e outros parâmetros.

  • Siga o guia Aceitar um pagamento para elaborar uma integração de checkout que usa formas de pagamento dinâmicas.
  • Se você não quiser usar o formas de pagamento dinâmico, siga as etapas abaixo para configurar manualmente as formas de pagamento em sua integração de checkout.

Stripe Checkout shows PayPal either as a standard payment method or as a standalone button, depending on which option is more likely to increase the conversion rate.

Verificar a compatibilidade

A Checkout Session must satisfy all of the following conditions to support PayPal payments:

  • Os preços de todos os produtos incluídos no checkout precisam estar na mesma moeda. Se você tiver produtos em moedas diferentes, crie sessões do Checkout separadas para cada moeda.

Aceitar um pagamento

Nota

Crie uma integração para aceitar um pagamento com o Checkout antes de usar este guia.

This guides you through enabling PayPal and shows the differences between accepting payments using dynamic payment methods and manually configuring payment methods.

Enable PayPal as a payment method

When creating a new Checkout Session, do the following:

  1. Add paypal to the list of payment_method_types.
  2. Make sure all your line_items use the same currency.
Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "line_items[0][price_data][currency]"=usd \
  -d "line_items[0][price_data][product_data][name]"=T-shirt \
  -d "line_items[0][price_data][unit_amount]"=2000 \
  -d "line_items[0][quantity]"=1 \
  -d mode=payment \
  -d "payment_method_types[0]"=card \
  -d "payment_method_types[1]"=paypal \
  --data-urlencode success_url="https://example.com/success"

Executar pedidos

After accepting a payment, learn how to fulfill orders.

Teste sua integração

You don’t need to connect your PayPal business account to test the integration. However, make sure to connect your PayPal and Stripe accounts when you’re ready to activate live mode payments.

When Checkout shows the PayPal button, you need a personal PayPal Sandbox account to complete the test payment. If Checkout lists PayPal as a payment method instead, select PayPal and click Pay—no PayPal Sandbox account is required.

To simulate the most common integration and failure scenarios for PayPal payments, pass email values that match the patterns described in these test scenarios.

Test scenarios

Email patternCenárioExplicação
.*payee_account_restricted@.*Merchant account restrictedCapturing or authorizing a payment fails with a payment_method_unexpected_state error if your merchant account is restricted by PayPal. Provide an email matching this pattern at time of authorization to fail the authorization.
.*transaction_refused@.*Transaction refusedCapturing a payment fails with a payment_method_provider_decline error if the transaction is refused by PayPal.
.*instrument_declined@.*Payment instrument declinedCapturing a payment fails with a payment_method_provider_decline error if the instrument presented was either declined by the processor or bank, or it can’t be used for this payment.
.*authorization_expired@.*Manually capturing an authorized paymentCapturing an authorized payment fails with a capture_charge_authorization_expired error if the authorization has already expired.

Gerencie reembolsos e contestações

Learn more about PayPal disputes and refunds.