Guides

Overview

Prerequisites

  • Sweuze merchant account (portal-test.sweuze.com)
  • HTTPS endpoint for webhooks
  • API keys from the Developer Area

Integration

  1. Create API keys at portal-test.sweuze.com
  2. Implement authentication (X-Key + X-Signature)
  3. Choose an integration path
  4. Configure webhook endpoint
  5. Fulfill orders from webhook state

Integration Paths

Path Entry point Use when
Direct payment intent POST /v1/payment-intents Your system collects all method-specific data before starting the payment.
Hosted checkout POST /v1/checkout-sessions Sweuze should collect or review payer data on a hosted page before creating the payment intent.

Both paths end in the same payment intent and payment lifecycle. Use webhooks for final state.

Core Endpoints

Method Endpoint Purpose
GET /v1/payment-methods?currency=EUR List methods enabled for the given currency
POST /v1/payment-intents Create a payment intent
POST /v1/checkout-sessions Create a hosted checkout session
GET /v1/checkout-sessions/{sessionId} Get checkout session state
GET /v1/payment-intents/{intentId} Get a payment intent's status and action
GET /v1/payments/{paymentId} Get a payment once the intent has one (see paymentId)

Base URL

API test environment: https://api-test.sweuze.com/v1

Hosted checkout links returned by the API use https://pay-test.sweuze.com/v1/checkout/....

Next Steps

Next
Overview