Een uitcheckpagina bouwen met Kayana's Stripe Plugin (Python)

Overzicht

De

Kayana Payment API

stelt u in staat betalingen van klanten te accepteren

zonder uw eigen checkout-infrastructuur op te bouwen

. Deze handleiding begeleidt u door de integratie van de betalingsstroom met behulp van de

Stripe Plugin geschreven in Python

. De plugin handelt het volgende af:

• Betalingssessies maken
• Communicatie met de Kayana payment API
• Stripe Embedded Checkout laden
• Betalingen veilig verwerken

In plaats van handmatig de Kayana payment APIs aan te roepen, biedt de plugin een vereenvoudigd invoerpunt: POST /launch Dit eindpunt:

1. Maakt een betalingssessie
2. Opent de checkout-pagina automatisch
3. Roept intern de Kayana payment gateway aan
4. Initialiseert Stripe Embedded Checkout
5. Verwerkt de betaling veilig

Wat u gaat bouwen

In deze handleiding gaat u:

• Een betalingsinstantie maken met de Kayana API • De Stripe publishable_key en client_secret ophalen• De Stripe Embedded Checkout UI laden• De betaling veilig verwerken

Serverinstellingen

Start de plugin server.

• python stripe_plugin.py

Server draait op:

• http://localhost:<port_number>

Beschikbare eindpunten:

• POST /launch
• POST /api/business-payment
• GET /proxy/debug

GET /docs

Voordat u begint

U heeft het volgende nodig:

• Een Kayana Property ID
• Een geldige Kayana API Key
• Python geïnstalleerd
• Basiskennis van Python APIs en HTTP-verzoeken
• Start de plugin server.
• python stripe_plugin.py
• Server draait op:
• http://localhost:<port_number>
• Beschikbare eindpunten:
• POST /launch
• POST /api/business-payment
• GET /proxy/debug
• GET /docs

Sandbox versus Productie

Sandbox:

https://integration.dev.kayana.co.uk

Productie:

https://integration.kayana.co.uk

Hoe het werkt

De betalingsstroom bestaat uit

drie hoofdstappen

.

Stap 1 — Server-zijde

Maak een

betalingsinstantie

en ontvang: publishable_key client_secret

Stap 2 — Server-zijde

Geef deze sleutels terug aan de frontend.

Stap 3 — Client-zijde

Laad

Stripe Embedded Checkout

met behulp van deze sleutels en voltooi de betaling.

De Python server instellen

Start de plugin:

python stripe_plugin.py Na het starten draait de server op: http://localhost:8000 De plugin biedt verschillende eindpunten.

Stap 1 — Betalingsinstantie maken (Stripe-sleutels ophalen)

De checkout-pagina haalt vervolgens de Stripe-betalingssleutels op. De plugin roept intern de Kayana API aan: POST /web/payment Dit verzoek retourneert:

• publishable_key
• client_secret

Beide sleutels zijn vereist om

Stripe Embedded Checkout

te initialiseren.

cURL-verzoek

curl -X POST https://integration.dev.kayana.co.uk/web/payment \ -H "Content-Type: application/json" \ -H "x-api-key: YOUR_API_KEY" \ -H "type: business" \ -d '{ "property_id": "Prop_abc123example", "psp_code": "STRIPE", "currency_code": "GBP", "amount": 12.0, "payment_mode": "CARD" }'

Voorbeeld van reactie

{ "status": true, "data": { "publishable_key": "pk_test_123456789", "client_secret": "cs_test_987654321" } }

Stap 2 — De Checkout-sessie starten

De eerste stap is om het betalingsproces te starten met behulp van het

/launch

eindpunt

van de plugin. Dit eindpunt:

• valideert het verzoek
• maakt een betalingssessie
• slaat de betalingsmetagegevens op
• opent de checkout-pagina in de browser

Eindpunt

POST /launch

Voorbeeld cURL

curl -X POST http://localhost:8000/launch \ -H "Content-Type: application/json" \ -d '{ "property_id": "Prop_abc123example", "currency_code": "GBP", "amount": 12.0, "customer_email": "customer@example.com" }'

Voorbeeld van reactie

{ "launched": true, "session_id": "abc123-session-id", "url": "http://localhost:8000/?session_id=abc123-session-id" } Dit opent de checkout-pagina: http://localhost:8000/?session_id=SESSION_ID

Stap 3 — Stripe Embedded Checkout laden

De frontend laadt Stripe en initialiseert checkout.

Stripe SDK opnemen

<script src="https://js.stripe.com/v3/"></script>

Stripe initialiseren

const stripe = Stripe(publishableKey);

Embedded Checkout koppelen

const checkout = await stripe.initEmbeddedCheckout({ clientSecret }); checkout.mount('#stripe-checkout-container'); Stripe geeft nu het beveiligde betalingsformulier weer.

Ondersteuning

Hulp nodig?

• Technische problemen: Neem contact op met Kayana Technical Support
• Productiereferenties: Vraag deze op bij uw Kayana-accountmanager
• PSP-configuratie: Neem contact op met Kayana Technical Support

Volgende stappen

• Ontdek webhook-integratie voor betalingsmeldingen
• Meer informatie over terugbetalingen en geschillenafhandeling
• Stel terugkerende betalingen in voor abonnementen

Volgende stappen

Als u liever RYFT als uw betalingsleverancier (PSP) gebruikt, ondersteunt Kayana ook een volledige RYFT-integratiestroom. Raadpleeg onze handleiding over het bouwen van een geavanceerde Kayana-integratie met RYFT in Python.