API per sviluppatori
Integrare con Schemi URL
Avvia il pagamento per Stripe dalla tua app o dal tuo sito web per elaborare le transazioni. Trasmetti i dati del cliente, gli importi e le informazioni sui prodotti, quindi gestisci la richiamata al termine.
Come funziona
La tua app apre un pagamento:// URL con parametri
Il pagamento per Stripe avvia ed elabora la transazione
Al termine, l'app reindirizza all'URL di callback con il risultato
Punti finali
Crea un addebito
payment://new?Elabora un pagamento una tantum con importo, valuta e descrizione.
Parametri
| Nome | Tipo | Necessario | Descrizione |
|---|---|---|---|
amount | integer | SÌ | Importo in centesimi (ad esempio, 1000 = $ 10,00) |
currency | string | NO | Codice valuta ISO a tre lettere (predefinito: USD) |
description | string | NO | Descrizione dell'addebito codificata in URL |
customer | string | NO | ID cliente Stripe esistente |
email | string | NO | Email del cliente per la ricevuta |
name | string | NO | Nome del cliente codificato in URL |
metadata | string | NO | Coppie chiave-valore personalizzate (JSON codificato in URL) |
callback | string | NO | URL a cui tornare dopo il completamento |
autoprocess | boolean | NO | Salta la schermata iniziale e inizia subito la ricarica |
Crea una fattura
payment://cart?Crea una fattura Stripe con le voci del tuo catalogo prodotti.
Parametri
| Nome | Tipo | Necessario | Descrizione |
|---|---|---|---|
prices | string | SÌ | ID dei prezzi separati da virgole con quantità (ad esempio, price_abc:2,price_xyz:1) |
customer | string | NO | ID cliente Stripe esistente |
email | string | NO | Email del cliente per la ricevuta |
name | string | NO | Nome del cliente codificato in URL |
callback | string | NO | URL a cui tornare dopo il completamento |
Gestione delle richiamate
Una volta completata la transazione, Payment for Stripe reindirizza all'URL di callback con parametri di query che indicano il risultato.
Parametri di callback
| Parametro | Valori | Descrizione |
|---|---|---|
status | success | error | cancelled | Risultato della transazione |
charge_id | string | ID addebito Stripe (in caso di successo) |
error | string | Messaggio di errore (in caso di errore) |
Esempi
Carica semplice
Addebita $ 10,00 con un solo importo
payment://new?amount=1000Carica con descrizione
Addebita € 25,00 con descrizione
payment://new?amount=2500¤cy=eur&description=Coffee%20and%20pastryAddebita con nuovo cliente
Addebita $ 50,00 e crea un record cliente
payment://new?amount=5000&name=John%20Smith&[email protected]Addebita al cliente esistente
Addebita $ 75,00 a un cliente Stripe esistente
payment://new?amount=7500&customer=cus_ABC123xyzCarica con metadati
Addebita $ 100,00 con metadati personalizzati per i tuoi record
payment://new?amount=10000&description=Invoice%20%231234&metadata=%7B%22order_id%22%3A%221234%22%2C%22location%22%3A%22Store%20A%22%7DElaborazione automatica con callback
Salta la schermata iniziale e torna all'app quando hai finito
payment://new?amount=3500&autoprocess=true&callback=myapp://payment-completeFattura con voci di riga
Crea una fattura con i prodotti dal tuo catalogo Stripe
payment://cart?prices=price_coffee:2,price_muffin:1&[email protected]Esempio completo
Tutti i parametri combinati per un flusso completamente integrato
payment://new?amount=15000¤cy=usd&description=Service%20Fee&customer=cus_ABC123xyz&metadata=%7B%22invoice%22%3A%22INV-2024-001%22%7D&autoprocess=true&callback=myapp://payment-resultCodifica URL
Ricordatevi di codificare i caratteri speciali nell'URL nei valori dei parametri. Gli spazi diventano %20, le parentesi graffe diventano %7B e %7D.
Pronti per l'integrazione?
Scarica l'app e inizia subito a testare la tua integrazione.