Käynnistä Payment for Stripe sovelluksestasi (URL-mallit) – Payment for Stripe

Lyhyt vastaus: Sovelluksesi avaa payment:// -URL-osoitteen, Payment for Stripe ottaa maksun vastaan ja avaa sitten callback-URL-osoitteesi tuloksen kanssa. Ei SDK:ta. Ei palvelinta.

Täydellinen viite löytyy osoitteesta paymentforstripe.com/api.

Näin se toimii

Sovelluksesi avaa payment:// -URL-osoitteen parametreilla.
Payment for Stripe avautuu ja ostos käynnistyy. Kauppias vastaanottaa maksun lukijalla, Tap to Pay tai syötetyllä kortilla.
Kun se on valmis, sovellus avaa callback URL-osoitteesi ja lisää tuloksen kyselyparametreina.

Kauppiaan on oltava kirjautuneena sisään. Jos linkki saapuu toisen laskun käsittelyn aikana, sovellus hylkää sen ja takaisinkutsussa näkyy error=charge_in_progress.

Luo lasku: payment://new

Kertaluonteinen maksu asettamasi summan verran.

Nimi	Tyyppi	Pakollinen	Kuvaus
`amount`	kokonaisluku	Kyllä	Määrä valuutan pienimmässä yksikössä, joka on suurempi kuin 0. `1000` = 10,00 dollaria.
`currency`	jono	Ei	Kolmikirjaiminen ISO-koodi, kuten `usd` tai `eur`. Jätä se pois, niin sovellus käyttää sille jo asetettua valuuttaa.
`description`	jono	Ei	Laskun kuvaus. URL-koodaa se.
`customer`	jono	Ei	Olemassa oleva Stripe-asiakastunnus ( `cus_…`). `customer_id` toimii myös. Kun se on asetettu, `email` ja `name` ohitetaan.
`email`	jono	Ei	Asiakkaan sähköpostiosoite. Luo uuden asiakkaan.
`name`	jono	Ei	Asiakkaan nimi. URL-koodaa sen. Luo uuden asiakkaan.
`metadata`	jono	Ei	URL-koodattu JSON-objekti, joka koostuu avain-arvo-pareista ja lisätään maksuun. Stripe metatietorajoitukset ovat voimassa.
`callback`	jono	Ei	URL-osoite, joka avataan myynnin päätyttyä.
`autoprocess`	totuusarvo	Ei	Arvo `true` ohittaa näppäimistön ja aloittaa laskun heti. Oletusarvo `false`.
`auto_return`	totuusarvo	Ei	`true` avaa takaisinkutsutoiminnon heti, kun tulos on tiedossa. Oletusarvo `false`: takaisinkutsu odottaa, kunnes kauppias sulkee tulosnäytön.

 payment://new?amount=2500&currency=eur&description=Coffee%20and%20pastry

 payment://new?amount=3500&autoprocess=true&auto_return=true&callback=myapp://payment-complete

Linkkiä, jonka amount puuttuu, on nolla tai ei ole numeerinen, ei oteta huomioon.

Luo lasku luettelostasi: payment://cart

Täyttää ostoskorin Stripe-tuoteluettelosi hinnoilla. Kauppias maksaa sitten normaalisti, ja myynti tallennetaan Stripe maksettuna laskuna kyseisillä nimikkeillä. Se ei lähetä laskua asiakkaallesi sähköpostitse.

Nimi	Tyyppi	Pakollinen	Kuvaus
`prices`	jono	Kyllä	Pilkuilla erotetut `price_id:quantity` parit, kuten `price_abc:2,price_xyz:1`. `line_items` toimii myös.
`coupon`	jono	Ei	Stripe kuponkitunnus ostoskoriin käytettäväksi.
`customer`	jono	Ei	Olemassa oleva Stripe-asiakastunnus, `customer_id` toimii myös.
`email`	jono	Ei	Asiakkaan sähköpostiosoite. Luo uuden asiakkaan.
`name`	jono	Ei	Asiakkaan nimi. URL-koodaa se.
`metadata`	jono	Ei	URL-koodattu avain-arvo-parien JSON-objekti.
`callback`	jono	Ei	URL-osoite, joka avataan myynnin päätyttyä.
`autoprocess`	totuusarvo	Ei	`true` aloittaa laskun, kun jokainen hinta (ja kuponki) on latautunut.
`auto_return`	totuusarvo	Ei	Sama kuin yllä. Oletusarvo `false`.

 payment://cart?prices=price_coffee:2,price_muffin:1&email=customer@example.com

Älä lähetä amount prices yhteydessä. Kokonaissumma tulee hinnoista, ja linkkiä molemmilla ei käytetä. payment_hidden- metodilla piilotetut hinnat toimivat tässäkin.

Maksa olemassa oleva lasku: payment://invoice

Kerää maksun avoimesta Stripe-laskusta henkilökohtaisesti. Summa, valuutta, asiakas ja vero tulevat laskusta. Onnistuessaan sovellus merkitsee laskun maksetuksi. Toimii iPhonella ja Androidilla.

Nimi	Tyyppi	Pakollinen	Kuvaus
`id`	jono	Kyllä	Stripe-laskun tunnus. Sen on alettava merkkijonoilla `in_`. Lähetä avoin lasku. iPhonella luonnos viimeistellään ensin. Androidilla luonnos hylätään virheellä `error=invoice_state_changed`.
`metadata`	jono	Ei	URL-koodattu JSON-objekti, lisätty PaymentIntent-objektiin.
`callback`	jono	Ei	URL-osoite, joka avataan myynnin päätyttyä. Hakee onnistumisen jälkeen `invoice_id` ja `payment_intent_id`.
`autoprocess`	totuusarvo	Ei	`true` käynnistää laskun laskutarkistusten läpäisyn jälkeen, vain silloin, kun kortinlukija on kytketty.
`auto_return`	totuusarvo	Ei	Sama kuin yllä. Oletusarvo `false`.

 payment://invoice?id=in_1ABC123xyz&autoprocess=true&callback=myapp://invoice-paid

Lasku määrittää myynnin, joten kaikki amount, currency, customer, customer_id, email, name, description, coupon, prices tai line_items muuttujat saavat linkin hylätyksi virheellä error=invoice_invalid_param. Maksetut, mitätöidyt, perintäkelvottomat, 0 dollarin arvoiset, tilaukseen sidotut tai oletusmaksutapaa käyttäen veloitettavat laskut hylätään myös, ja jokaisella niistä on oma invoice_… -virhe.

Takaisinsoitto

Sovellus lisää nämä callback-URL-osoitteeseesi:

Nimi	Tyyppi	Lähetetty	Kuvaus
`status`	jono	Aina	`success`, `error` tai `cancelled`.
`charge_id`	jono	Menestyksestä	Maksun tunnus. iPhonella se on Stripe-lasku ( `ch_…`). Androidilla se on PaymentIntent ( `pi_…`).
`stripe_charge_id`	jono	Vain Androidille	Stripe-lakiesitys ( `ch_…`).
`payment_intent_id`	jono	Menestyksestä	PaymentIntent. iPhone lähettää sen vain `payment://invoice`. Android lähettää sen jokaista korttimaksua varten.
`invoice_id`	jono	Laskulinkit	Maksettu lasku, kohteelle `payment://invoice`.
`amount`	kokonaisluku	Menestyksestä	Laskutettu summa pienimmässä yksikössä.
`currency`	jono	Menestyksestä	Pienellä kirjaimella kirjoitettu ISO-koodi.
`error`	jono	Virheen sattuessa	Lyhyt koodi, kuten `charge_in_progress` tai `invoice_already_paid`, tai luettava viesti hylätylle kortille.

 myapp://payment-complete?status=success&charge_id=ch_3Qx…&success=true&amount=3500&currency=usd&chargeId=ch_3Qx…

Tarvitsetko saman tunnuksen molemmilla alustoilla? Lue ensin stripe_charge_id ja palaa sitten takaisin charge_id.

Vanhemmissa integraatioissa sovellus lähettää myös success=true, chargeId, cancelled=true ja error[message]. Uuden koodin pitäisi lukea status.

Peruutus avaa soittopyynnön välittömästi. Laskun onnistuminen tai virhe odottaa, että kauppias sulkee tulosnäytön, ellet anna auto_return=true. iPhonessa käteisosto ei koskaan avaa soittopyyntöä, koska mitään ei laskutettu.

URL-koodaus

Koodaa jokainen arvo, jossa on välilyöntejä tai symboleja. Välilyönneistä tulee %20, { ja } muotoon %7B ja %7D:stä " muotoon %22, : muotoon %3A.
Jos callback-URL-osoitteellasi on oma kyselymerkkijono, koodaa koko callback niin, että se & ei jaa payment:// linkkiäsi.
prices pilkut ja kaksoispisteet voivat pysyä ennallaan.

Metadatasta {"order_id":"1234","location":"Store A"} tulee:

 payment://new?amount=10000&description=Invoice%20%231234&metadata=%7B%22order_id%22%3A%221234%22%2C%22location%22%3A%22Store%20A%22%7D

Vanhempi metadata[order_id]=1234 -lomake toimii myös.