Kehittäjän API
Integroi URL-osoitteet
Käynnistä Stripen maksut sovelluksestasi tai verkkosivustoltasi käsitelläksesi maksutapahtumia. Välitä asiakastiedot, summat ja tuotetiedot ja käsittele sitten takaisinsoitto, kun maksu on valmis.
Näin se toimii
Sovelluksesi avautuu maksu:// URL-osoite parametreilla
Stripe-maksu käynnistää ja käsittelee tapahtuman
Kun sovellus on valmis, se ohjaa takaisinsoitto-URL-osoitteeseesi tuloksen kanssa.
Päätepisteet
Luo veloitus
payment://new?Käsittele kertaluonteinen maksu summalla, valuutalla ja kuvauksella.
Parametrit
| Nimi | Tyyppi | Pakollinen | Kuvaus |
|---|---|---|---|
amount | integer | Kyllä | Summa sentteinä (esim. 1000 = 10,00 $) |
currency | string | Ei | Kolmikirjaiminen ISO-valuuttakoodi (oletus: USD) |
description | string | Ei | URL-koodattu veloituksen kuvaus |
customer | string | Ei | Olemassa oleva Stripe-asiakastunnus |
email | string | Ei | Asiakkaan sähköpostiosoite kuittia varten |
name | string | Ei | URL-koodattu asiakkaan nimi |
metadata | string | Ei | Mukautetut avain-arvo-parit (URL-koodattu JSON) |
callback | string | Ei | URL-osoite, johon palataan valmistumisen jälkeen |
autoprocess | boolean | Ei | Ohita aloitusnäyttö ja aloita lataus heti |
Luo lasku
payment://cart?Luo Stripe-lasku, joka sisältää tuoteluettelosi rivikohtia.
Parametrit
| Nimi | Tyyppi | Pakollinen | Kuvaus |
|---|---|---|---|
prices | string | Kyllä | Pilkuilla erotetut hintatunnukset määrien kanssa (esim. price_abc:2, price_xyz:1) |
customer | string | Ei | Olemassa oleva Stripe-asiakastunnus |
email | string | Ei | Asiakkaan sähköpostiosoite kuittia varten |
name | string | Ei | URL-koodattu asiakkaan nimi |
callback | string | Ei | URL-osoite, johon palataan valmistumisen jälkeen |
Takaisinsoittojen käsittely
Kun maksutapahtuma on valmis, Payment for Stripe ohjaa sinut takaisinsoitto-URL-osoitteeseesi, jonka kyselyparametrit osoittavat tuloksen.
Takaisinkutsuparametrit
| Parametri | Arvot | Kuvaus |
|---|---|---|
status | success | error | cancelled | Transaktion tulos |
charge_id | string | Stripe-maksutunnus (onnistuttuaan) |
error | string | Virheilmoitus (virheen sattuessa) |
Esimerkkejä
Yksinkertainen lataus
Veloita 10,00 dollaria pelkällä summalla
payment://new?amount=1000Veloitus kuvauksella
Veloitus 25,00 € kuvauksella
payment://new?amount=2500¤cy=eur&description=Coffee%20and%20pastryVeloita uudelta asiakkaalta
Veloita 50,00 dollaria ja luo asiakastietue
payment://new?amount=5000&name=John%20Smith&[email protected]Veloita olemassa olevalta asiakkaalta
Veloita 75,00 dollaria olemassa olevalta Stripe-asiakkaalta
payment://new?amount=7500&customer=cus_ABC123xyzVeloita metadatan avulla
Veloita 100,00 dollaria mukautetuilla metatiedoilla tietueistasi
payment://new?amount=10000&description=Invoice%20%231234&metadata=%7B%22order_id%22%3A%221234%22%2C%22location%22%3A%22Store%20A%22%7DAutomaattinen käsittely takaisinkutsun avulla
Ohita aloitusnäyttö ja palaa sovellukseen, kun olet valmis
payment://new?amount=3500&autoprocess=true&callback=myapp://payment-completeLasku, jossa on rivejä
Luo lasku Stripe-luettelosi tuotteista
payment://cart?prices=price_coffee:2,price_muffin:1&[email protected]Täydellinen esimerkki
Kaikki parametrit yhdistettynä täysin integroitua virtausta varten
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-resultURL-koodaus
Muista URL-koodata erikoismerkit parametriarvoissa. Välilyönneistä tulee %20, aaltosulkeista %7B ja %7D.
Valmiina integroitumaan?
Lataa sovellus ja aloita integraatiosi testaaminen jo tänään.