API

Um esquema de URL simples e fácil de usar para integrar sua empresa ao Payment for Stripe.

Redirecione facilmente de qualquer aplicativo ou site iOS diretamente para o aplicativo de pagamento para receber o pagamento.

Preencher uma nova cobrança

Passe os dados para Payment para criar cobranças: payment://new?

Adicione um valor, em centavos: payment://new?amount=2000

Escolha uma moeda suportada: payment://new?currency=usd

Adicione uma descrição codificada de URL para a cobrança: payment://new?description=Cat+Sweater

Criar uma fatura com itens de linha

Como alternativa, crie uma fatura Stripe de item de linha: payment://cart?

Passe um id de preço e um par de quantidade: payment://cart?line_items=price_xxx:3

Ou repasse vários IDs de preços e quantidades: payment://cart?line_items=price_abc:3,price_xyz:2

Além disso, você pode aplicar um cupom: payment://cart?coupon=kZjFzekm

Fornecer informações do cliente (opcional)

Adicione um nome de URL codificado para o cliente: payment://new?name=John+Doe

Forneça um endereço de e-mail para um recibo: payment://new?email=john@doe.com

Forneça um URL de retorno de chamada

Após uma transação bem-sucedida, o aplicativo de pagamento retornará ao seu aplicativo. payment://new?callback=https://foo.bar.com/hook

Além de o iOS levar você automaticamente de volta ao seu site, também retornaremos algumas informações, incluindo: https://foo.bar.com/hook?success=true&
  amount=2000&currency=usd&
  chargeId=pi_xxxxxx

Em caso de erro, você pode receber uma mensagem formatada como: https://foo.bar.com/hook?error[message]=Card+declined

https://foo.bar.com/hook?cancelled=true

Utilize um cliente existente

Utilize um cliente Stripe existente, informando o ID dele: payment://new?customer_id=cus_xxxxxx

Isso pré-seleciona o cliente para a transação, de forma que seus métodos de pagamento salvos fiquem disponíveis.

Incluir metadados personalizados

Forneça metadados personalizados para incluir na cobrança do Stripe: payment://new?metadata[order_id]=12345

Adicione vários campos de metadados conforme necessário: payment://new?metadata[order_id]=12345&
  metadata[source]=pos

Processamento automático de pagamentos

Ignore a tela inicial e inicie o carregamento imediatamente: payment://new?amount=2000&auto=true

O pagamento começará automaticamente quando o aplicativo for aberto. Se um leitor de cartão estiver conectado, ele solicitará o pagamento imediatamente.

Exemplo completo

Eis um exemplo que combina tudo:

payment://new?amount=2000&
  currency=usd&
  customer_id=cus_xxxxxx&
  metadata[order_id]=12345&
  callback=myapp://payment&
  auto=true

Quer algo mais da API?
Nos informe