Siemens Gateway Protocol

Integration Guide

Build the payment flow without losing the product story.

This page gives the site a developer-facing anchor: how to create checkout sessions, what channels the gateway supports, and how merchants receive status events from the platform.

API example

POST /v1/checkout-sessions
{
  "orderId": "ord_1048",
  "amount": "249.00",
  "currency": "USD",
  "settlementAsset": "USDC",
  "customerEmail": "[email protected]",
  "successUrl": "https://merchant.example/paid",
  "cancelUrl": "https://merchant.example/cancelled"
}

Launch sequence

  • Create a merchant account and choose supported settlement assets.
  • Generate API keys, webhook secret, and hosted checkout branding settings.
  • Create checkout sessions from your app, then listen for status updates asynchronously.

Integration Channels

Different routes to the same payment layer

Direct API for custom commerce stacks

Hosted checkout for fastest launch

Payment links for support and manual sales flows

Plugin adapters for common storefront platforms

Webhook events

  • checkout_session.pending when the address is created and awaiting funds
  • checkout_session.confirmed when the payment is fully confirmed
  • checkout_session.partial when less than the requested amount arrives
  • checkout_session.expired when the payment window closes

Why this page matters

The integration guide is the page that makes the whole site feel like a product instead of only a visual concept. It gives founders, engineers, and potential partners enough implementation detail to understand how the gateway could actually be used.