API

Uno schema URL semplice e facile da usare per integrare la tua attività con Payment for Stripe.

Reindirizza facilmente da qualsiasi app o sito Web iOS, direttamente nell'app di pagamento per ricevere i pagamenti.

Popolare una nuova carica

Passa i dati a Payment per creare addebiti: payment://new?

Aggiungi un importo, in centesimi: payment://new?amount=2000

Scegli una valuta supportata: payment://new?currency=usd

Aggiungi una descrizione con codifica URL per l'addebito: payment://new?description=Cat+Sweater

Crea una fattura con voci

In alternativa, crea una fattura Stripe con voce di riga: payment://cart?

Passa una coppia ID prezzo e quantità: payment://cart?line_items=price_xxx:3

Oppure trasmetti più ID prezzo e quantità: payment://cart?line_items=price_abc:3,price_xyz:2

Inoltre, puoi applicare un coupon: payment://cart?coupon=kZjFzekm

Fornire informazioni sul cliente (facoltativo)

Aggiungi un nome codificato URL per il cliente: payment://new?name=John+Doe

Fornire un indirizzo e-mail per una ricevuta: payment://new?email=john@doe.com

Fornisci un URL di richiamata

Dopo una transazione andata a buon fine, l'app Payment tornerà alla tua app. payment://new?callback=https://foo.bar.com/hook

Oltre a riportarti automaticamente sul tuo sito Web da iOS, ti restituiremo anche alcune informazioni tra cui: https://foo.bar.com/hook?success=true&
  amount=2000&currency=usd&
  chargeId=pi_xxxxxx

In caso di errore, potresti ricevere un messaggio formattato come: https://foo.bar.com/hook?error[message]=Card+declined

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

Utilizzare un cliente esistente

Utilizza un cliente Stripe esistente trasmettendo il suo ID: payment://new?customer_id=cus_xxxxxx

In questo modo il cliente viene preselezionato per la transazione, rendendo disponibili i suoi metodi di pagamento salvati.

Includi metadati personalizzati

Trasmetti metadati personalizzati da includere nell'addebito su Stripe: payment://new?metadata[order_id]=12345

Aggiungere più campi di metadati secondo necessità: payment://new?metadata[order_id]=12345&
  metadata[source]=pos

Elaborazione automatica dei pagamenti

Salta la schermata iniziale e avvia subito la ricarica: payment://new?amount=2000&auto=true

Il pagamento inizierà automaticamente all'apertura dell'app. Se è collegato un lettore di carte, verrà richiesto immediatamente il pagamento.

Esempio completo

Ecco un esempio che combina tutto insieme:

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

Vuoi qualcosa di più dall'API?
Facci sapere