Docs

Pagamentos

Conectar PayPal

Os compradores pagam na sua própria conta PayPal. Em preços abaixo de US$ 10, o PayPal custa menos que o Stripe quando libera para você a tarifa de micropagamentos; na tarifa padrão, o Stripe custa menos.

Conecte sua conta

O PayPal se conecta pelo seu próprio app REST do PayPal: um no sandbox do PayPal para teste e um de produção.

  1. Crie um app REST. No painel de desenvolvedor do PayPal, em Apps & Credentials, crie um app no sandbox. Crie um de produção quando entrar em produção.
  2. Conecte. Em Pagamentos, na seção PayPal, escolha Conectar no lado Teste e conecte seu app sandbox. Guardamos o segredo dele criptografado.
  3. Adicione nosso webhook. Na página Webhooks do app no PayPal, adicione o endereço que Pagamentos mostra, exatamente como aparece.
  4. Marque quatro eventos. PAYMENT.CAPTURE.COMPLETED, PAYMENT.CAPTURE.REFUNDED, CUSTOMER.DISPUTE.CREATED e CUSTOMER.DISPUTE.RESOLVED.
  5. Envie um evento de teste. Use Simulate events nessa página. Ele aparece em Pagamentos em até um minuto.
  6. Conecte a conta real ao entrar em produção. Repita estes passos com seu app de produção no lado Produção.
  • Uma conexão serve para todos os seus apps. Teste e produção se conectam separadamente.
  • Conectar ou desconectar pede que você confirme de novo que é você se entrou há mais de 10 minutos.
  • Se a maioria dos seus preços for abaixo de US$ 10, peça ao PayPal a tarifa de micropagamentos.

Como o comprador paga

O QR code do relógio abre o próprio site do PayPal no celular, já vinculado àquele relógio. O comprador aprova o pagamento ali com o saldo do PayPal ou um cartão, e então o concluímos na sua conta. O dinheiro cai no seu saldo do PayPal; saque pelo PayPal.

O que escutamos

Evento do PayPalO que significaO que o relógio faz
PAYMENT.CAPTURE.COMPLETEDPagoDesbloqueia em cerca de um segundo se a tela de compra estiver aberta; senão, na próxima consulta.
PAYMENT.CAPTURE.REFUNDEDReembolsadoBloqueia na próxima verificação; na hora, se a tela de compra estiver aberta.
CUSTOMER.DISPUTE.CREATEDUma contestação abertaBloqueia enquanto a contestação estiver aberta.
CUSTOMER.DISPUTE.RESOLVEDA contestação terminouGanha: o relógio desbloqueia de novo, salvo reembolso. Perdida: continua bloqueado.

Conferimos cada evento com o checkout que criamos: o relógio e o app, o valor, a moeda, e se é sandbox ou produção.

Se o PayPal não conseguir nos alcançar

Se as tentativas do PayPal de nos alcançar falharem, Pagamentos mostra Precisa de atenção e Ver a correção. Enquanto isso os pagamentos continuam passando, mas reembolsos não bloqueiam relógios até voltar a funcionar. A correção:

  1. Abra os webhooks do seu app. Painel de desenvolvedor do PayPal, Apps & Credentials, seu app, Webhooks.
  2. Confira o endereço. Ele deve ser exatamente igual ao que Pagamentos mostra.
  3. Confira os eventos. Os quatro da tabela acima.
  4. Envie um evento de teste. Simulate events. Em até um minuto ele aparece e o alerta some.

Reembolsos e contestações

  • Reembolse no PayPal. Uma venda em Vendas leva direto para lá.
  • Responda às contestações no PayPal. O relógio fica bloqueado enquanto houver uma contestação aberta.
  • Teste só no sandbox: pague com uma conta de comprador do sandbox e reembolse pelo sandbox. Nunca faça reembolsos ou contestações na sua conta de produção para testar.

O lado do relógio em cada caso está em Reembolsos, contestações e renovações.

Esc