Isännöity kassa

Jokaisella maksuaikomuksella on isännöity kassa osoitteessa checkout_url, joka tarjoillaan osoitteesta https://checkout.feitpay.com. Kassa on nopea, siinä ei ole 3D-tehosteita ja se toimii ilman animaatioita; se näyttää kauppiaan nimen ja logon vain siistityistä kaupan brändäystiedoista yhdessä verkkotunnuksen vahvistuksen merkkien kanssa, ja se kertoo asiakkaalle selvästi, kuka maksun vastaanottaa.

Kassaistuntoja on vain live-maksuaikomuksille, joten ne ovat käytettävissä, kun tilisi on aktivoitu.

Kassaistunnot

Kassaistunto on läpinäkymätön, lyhytikäinen käyttöoikeus-URL yhdelle maksuaikomukselle — cs_ ja sen perässä 32 satunnaista merkkiä. Tunniste itsessään antaa pääsyn siistittyyn julkiseen näkymään, joten:

• älä koskaan laita API-avaimia selaimeen — kassa ei koskaan tarvitse niitä;
• käsittele URL-osoitetta kuin kyseisen maksun salasanaa (älä kirjaa sitä julkisesti);
• luo avoimelle aikomukselle uusi istunto, jos edellinen vanheni.

POST/v1/checkout-sessionslive · tilin aktivoinnin jälkeen

{ "payment_intent_id": "pi_01J…" }

Istunnon tila on open, complete tai expired.

Mitä asiakas näkee

1. Summa valuutassasi ja kaupan tiedot.
2. Selkeä ilmoitus siitä, että asiakas maksaa FeitPayn lompakkoon Bitcartin kautta käsiteltynä ja että summa hyvitetään sinulle, kun maksu on vahvistettu (live-maksut ovat säilyttäviä).
3. Maksutavat — kassa avaa laskun alustan Bitcart-tilillä ja luettelee jokaiselle hyväksytylle varalle Bitcartin vaihtokurssilla lasketun tarkan summan, osoitteen ja QR-koodin. Kopiointipainikkeet antavat välittömän palautteen.
4. Reaaliaikainen tila aikajanan kera. Palvelimen lähettämät tapahtumat (server-sent events) välittävät muutokset; tarvittaessa sivu kyselee tilaa 3 sekunnin välein.
5. Onnistumis-, odotus-, epäonnistumis- ja vanhentumissivut. Vahvistuksen jälkeen asiakas voi palata return_url-osoitteeseesi.

Kassa ei koskaan vaihda varaa huomaamatta eikä koskaan tilitä osittaisia tai myöhästyneitä maksuja automaattisesti — ne kulkevat tilakoneen, säilytyssaldoon tehtävää hyvitystä edeltävän ylläpitäjän tarkistuksen ja sinun päätöksesi kautta.

Huomio

Kryptomaksut eivät ole korttimaksuja: takaisinperintöjä (chargeback) ei ole. Palautukset eivät koskaan ole automaattisia; kauppias palauttaa varat esimerkiksi nostona asiakkaan antamaan osoitteeseen.

Kassan käyttämät julkiset päätepisteet

Nämä sijaitsevat polun /v1/public/ alla ja vaativat vain istunnon tunnisteen:

Päätepiste	Tarkoitus
GET /v1/public/checkout-sessions/{id}	Siistitty istunto: maksun tila, processor (laskun tila ja maksutavat) ja aikajana
POST /v1/public/checkout-sessions/{id}/processor-invoice	Avaa laskun alustan Bitcart-tilillä ja palauttaa sen maksutavat. Idempotentti: myöhemmät kutsut palauttavat saman laskun
GET /v1/public/checkout-sessions/{id}/events	Palvelimen lähettämät status-tapahtumat
POST /v1/public/checkout-sessions/{id}/select-option	Vain pelkkään seurantaan perustuvassa käsittelyssä (ei käytössä tämän alustan maksuissa): valitse network_id + asset_id, lukitse tarjous ja määritä osoite
POST /v1/public/checkout-sessions/{id}/refresh-quote	Vain pelkkään seurantaan perustuvassa käsittelyssä: uusi tarjous vanhenemisen jälkeen (sama verkko ja osoite)

Voit käyttää samoja päätepisteitä (tai @feitpay/react-paketin useCheckoutSession-koukkua) näyttääksesi tilan omalla tilaussivullasi.

Paluu- ja peruutusosoitteet

return_url ja cancel_url on oltava hallitsemiasi absoluuttisia URL-osoitteita. Uudelleenohjaus return_url-osoitteeseen on mukavuustoiminto, ei todiste maksusta — luota aina allekirjoitettuun webhookiin ja fulfillable-kenttään.

Maksulinkit

Maksulinkki on uudelleenkäytettävä URL-osoite kiinteälle summalle — hyödyllinen sähköpostitse lähetettäville laskuille, lahjoituksille tai yksinkertaisille tuotteille. Jokainen käynti luo uuden maksuaikomuksen ja kassaistunnon, joten linkin voi maksaa vasta, kun tilisi on aktivoitu. Linkki kuuluu siihen ympäristöön, jossa se luotiin: luo jaettavat linkit, kun tilisi on aktivoitu.

POST/v1/payment-linkslive · tilin aktivoinnin jälkeen

{
  "store_id": "store_01J…",
  "title": "Workshop ticket",
  "amount": "120.00",
  "currency": "EUR"
}

Vastaus sisältää julkisen url-osoitteen sekä kentät sessions_count ja confirmed_count. Poista linkki käytöstä kutsulla PATCH /v1/payment-links/{id} rungolla { "active": false }. Älä aseta allowed_networks-kenttää live-maksujen linkeille: niiden luomat aikomukset torjuttaisiin koodilla allowed_networks_unsupported.