Payment Gateways

Endpointhttps://api.kontorion.eu/v1

A payment gateway configuration connects Kontorion to an external payment processor (Stripe, GoCardless, or other providers) for collecting payments from customers.

Each organization can have multiple gateway configurations - for example, Stripe for card payments and GoCardless for SEPA direct debits. One gateway is marked as the default.

Key concepts:

Provider - the payment processor (stripe, gocardless, etc.)
Mode - live or test - determines whether real charges are made
Supported currencies - which currencies this gateway can process
Supported methods - which payment methods this gateway handles (card, direct_debit, etc.)

List payment gateways

GET

https://api.kontorion.eu/v1

/payment-gateways

Returns all payment gateway configurations for the organization. Sensitive config fields are masked.

List payment gateways › Responses

List of gateway configs

object[]

Create a payment gateway configuration

POST

https://api.kontorion.eu/v1

/payment-gateways

Creates a new payment gateway configuration for the organization

Create a payment gateway configuration › Request Body

config

object

{ "api_key": "sk_...", "webhook_secret": "whsec_..." }

display_name

string

mode

string

provider

string

supported_currencies

string[]

supported_methods

string[]

Create a payment gateway configuration › Responses

Created gateway config

object

POST/payment-gateways

curl --request POST \
  --url https://api.kontorion.eu/v1/payment-gateways \
  --header 'Content-Type: application/json' \
  --data '
{
  "config": {},
  "display_name": "display_name",
  "mode": "mode",
  "provider": "provider",
  "supported_currencies": [
    "string"
  ],
  "supported_methods": [
    "string"
  ]
}
'

shell

Example Request Body

{
  "config": {},
  "display_name": "display_name",
  "mode": "mode",
  "provider": "provider",
  "supported_currencies": [
    "string"
  ],
  "supported_methods": [
    "string"
  ]
}

json

Example Responses

{
  "data": {
    "config": {},
    "created_at": "created_at",
    "display_name": "display_name",
    "id": "id",
    "is_default": true,
    "is_enabled": true,
    "metadata": {
      "key": {}
    },
    "mode": "mode",
    "organization_id": "organization_id",
    "provider": "provider",
    "supported_currencies": [
      "string"
    ],
    "supported_methods": [
      "string"
    ],
    "updated_at": "updated_at"
  }
}

json

application/json

Update a payment gateway configuration

PUT

https://api.kontorion.eu/v1

/payment-gateways/{id}

Updates an existing payment gateway configuration by ID

Update a payment gateway configuration › path Parameters

id

string · required

Gateway config UUID

Update a payment gateway configuration › Request Body

config

object

display_name

string

is_default

boolean

is_enabled

boolean

mode

string

supported_currencies

string[]

supported_methods

string[]

Update a payment gateway configuration › Responses

Update acknowledgement

object

Delete a payment gateway configuration

DELETE

https://api.kontorion.eu/v1

/payment-gateways/{id}

Deletes a payment gateway configuration by ID

Delete a payment gateway configuration › path Parameters

id

string · required

Gateway config UUID

Delete a payment gateway configuration › Responses

No content

No data returned

Promotions Payment Methods

Create a payment gateway configuration

POST

https://api.kontorion.eu/v1

/payment-gateways

Creates a new payment gateway configuration for the organization

Create a payment gateway configuration › Request Body

config

object

{ "api_key": "sk_...", "webhook_secret": "whsec_..." }

display_name

string

mode

string

provider

string

supported_currencies

string[]

supported_methods

string[]

Create a payment gateway configuration › Responses

Created gateway config

object

Update a payment gateway configuration

PUT

https://api.kontorion.eu/v1

/payment-gateways/{id}

Updates an existing payment gateway configuration by ID

Update a payment gateway configuration › path Parameters

id

string · required

Gateway config UUID

Update a payment gateway configuration › Request Body

config

object

display_name

string

is_default

boolean

is_enabled

boolean

mode

string

supported_currencies

string[]

supported_methods

string[]

Update a payment gateway configuration › Responses

Update acknowledgement

object