Maksuinfrastruktuuri

Maksukerros,joka todistaajokaisen vaiheen.

GRYPHEM PAY tarjoaa kauppiaille isännöidyn kassan, dokumentoidun rajapinnan ja maksun aikajanan, joka rakentuu todennettavista lohkoketjutapahtumista. Maksut kulkevat Bitcart-tilimme kautta, ja säilytämme varat puolestasi, kunnes nostat ne. Maksut otetaan käyttöön, kun tilisi on vahvistettu ja hyväksytty.

  • Säilyttävä käsittely Bitcartin kautta
  • Jokainen nosto tarkastetaan
  • Maksut tilin hyväksynnän jälkeen

01 — Luottamuksen hetki

Asiakas painaa maksupainiketta, ja arvo lähtee liikkeelle. Toisaalla kauppias odottaa varmuutta. Heidän välissään ovat kaikki kysymykset, joita maksu herättää — mikä verkko, mikä summa, kuinka lopullinen. GRYPHEM PAY vastaa jokaiseen todisteilla, joita voit lukea, tarkistaa ja säilyttää.

Jokaisella GRYPHEM PAY -tilalla on todisteensa: hintatarjous, transaktio, lohko, vahvistukset ja allekirjoitettu webhook.

02 — Pyynnöstä kuittiin

Yksi maksu, neljä rehellistä vaihetta.

  1. Luo maksuaikomus

    Palvelimesi lähettää summan ja valuutan live-avaimellasi. Idempotenssiavaimet tekevät uudelleenyrityksistä turvallisia.

    POST /v1/payment-intents
  2. Ohjaa kassalle

    Asiakas saapuu isännöidylle sivulle, jossa on tarkka summa ja Bitcart-tilimme tätä maksua varten antama osoite.

    GET /c/{checkout_session}
  3. Havaitse ja vahvista

    GRYPHEM tarkistaa jokaisen Bitcart-päivityksen ja merkitsee maksun vahvistetuksi vasta, kun lasku on valmis.

    detected → confirming → confirmed
  4. Vastaanota allekirjoitettu tapahtuma

    Päätepisteesi saa HMAC-allekirjoitetun webhookin, jonka tapahtumatunnisteella voit poistaa kaksoiskappaleet, ja summa kirjataan saldollesi.

    Gryphem-Signature: t=…,v1=…

03 — Kassa

Kassa, joka kertoo tarkalleen, mitä maksaa.

Isännöity kassa on nopea, ei käytä WebGL:ää eikä arvaa. Tämän asiakkaasi näkevät, kun maksut on otettu käyttöön tilillesi.

  • Tarkka summa

    Asiakkaan valitsemana kryptovarana, laskulta, jonka GRYPHEM PAY avaa Bitcart-tilillään tätä maksua varten.

  • Minne maksetaan

    Tätä maksua varten annettu osoite, QR-koodi ja linkki, joka avaa asiakkaan lompakon.

  • Tila reaaliajassa

    Havaittu, vahvistumassa ja vahvistettu — jokaisella nimi, kuvake ja selkokielinen syy.

  • Vahvistettu tarkoittaa valmista

    Maksu lasketaan vahvistetuksi vasta, kun Bitcart ilmoittaa laskun valmistuneen. Osittaiset ja myöhästyneet maksut menevät tarkastukseen.

Maksut otetaan käyttöön, kun tilisi on vahvistettu ja hyväksytty. Sitä ennen kauppaasi ei voi maksaa GRYPHEM PAYn kautta.

04 — Kehittäjille

Tehty niille, jotka lukevat vastauksen rungon.

Raaputa korttia kolikolla — tai paina ”Paljasta nyt” — nähdäksesi, mitä palvelimesi vastaanottaa, kun maksu vahvistuu.

Esimerkkisisältöpayment.confirmed

Gryphem-Signature: t=1792411471,v1=5f0c…e41b

{
  "event_id": "evt_01JEXAMPLE00000000000000",
  "event_type": "payment.confirmed",
  "api_version": "2026-10-01",
  "created_at": "2026-10-20T12:04:31Z",
  "merchant_id": "org_01JEXAMPLE00000000000000",
  "store_id": "store_01JEXAMPLE0000000000000",
  "environment": "live",
  "object": { "type": "payment_intent", "id": "pi_01JEXAMPLE00000000000000" },
  "data": {
    "status": "confirmed",
    "previous_status": "confirming",
    "status_reason": "bitcart_complete",
    "amount": "59.90",
    "currency": "EUR",
    "merchant_order_id": "order-123",
    "fulfillable": true,
    "quote": null,
    "totals": null
  }
}

Valmistaudu oikeisiin maksuihin

  1. Luo tili ja kauppa
  2. Lähetä yrityksesi tunnistamistiedot
  3. Luo gp_live_-avain, kun tilisi on hyväksytty
  4. Tarkista ensimmäinen allekirjoitettu webhook

Älä koskaan liitä tuotantoavainta selaimeen. Tämä sivu ei pyydä sellaista.

05 — Integraatio

Viisi vaihetta ensimmäiseen oikeaan maksuun.

  1. Luo kauppa

    Rekisteröidy, vahvista sähköpostisi ja luo organisaatio ja kauppa hallintapaneelissa.

    Avaa hallintapaneeli
  2. Tunnista yrityksesi

    Lähetä yrityksesi tunnistamistiedot. GRYPHEM tarkastaa ne käsin ja avaa organisaatiollesi oikeat maksut hyväksynnän jälkeen.

    Tuotantoon siirtyminen
  3. Luo maksuaikomuksia

    Kutsu rajapintaa live-avaimellasi. Jokainen luontipyyntö on idempotentti ja palauttaa kassan URL-osoitteen.

    Maksuaikomukset
  4. Ohjaa asiakkaat kassalle

    Ohjaa isännöityyn kassaan tai jaa maksulinkki. Tilat päivittyvät reaaliajassa.

    Isännöity kassa
  5. Tarkista webhookit ja täsmäytä

    Tarkista allekirjoitukset raakarunkoa vasten, poista kaksoiskappaleet tapahtumatunnisteella ja kysy rajapinnalta ennen toimitusta.

    Webhookit

Ensin tunnistaminen, sitten oikeat maksut.

Luo tili ja lähetä yrityksesi tunnistamistiedot jo nyt. Oikeat maksut perustuvat varojen säilyttämiseen, ja ne otetaan käyttöön vasta hyväksynnän jälkeen — säilytystoiminnan toimilupa mukaan lukien. Mikään ei tule yllätyksenä.