payment-accounts

Version 0.1.07 opérations

Payment accounts within your scope, with routing and providers

GET/organisations/{id}/payment-accountsClé API

Paramètres

idstringpathobligatoire
includeArchivedbooleanquery
Include archived accounts (default false)

Réponses

200
- idstring (uuid)obligatoire
- organisationIdstring (uuid)obligatoire
- namestringobligatoire
- slugstringobligatoire
- displayNamestring | nullobligatoire
  Checkout name; null uses name
- logoFileIdstring (uuid) | nullobligatoire
- themeColorstring | nullobligatoire
- successUrlstring | nullobligatoire
- failUrlstring | nullobligatoire
- statusstringobligatoire
  - enum: "active", "paused", "archived"
- isDefaultbooleanobligatoire
- archivedAtstring (date-time) | nullobligatoire
- routesRouteDto[]obligatoire
  - providerstringobligatoire
    - enum: "clictopay", "flouci", "izi", "mpgs_poste", "pluxee", "kashy", "enda_tao"
  - labelstringobligatoire
  - affiliationIdstring (uuid)obligatoire
  - affiliationStatusstringobligatoire
    Status of the affiliation; only active ones make the provider accepted
    - enum: "draft", "verifying", "active", "suspended", "revoked", "unknown"
- acceptedProvidersstring[]obligatoire
  Providers with an active routed affiliation; empty unless the account is active
- createdAtstring (date-time)obligatoire
- updatedAtstring (date-time)obligatoire

Exemples de code

curl -X GET "$KONNECT_API_URL/organisations/id/payment-accounts" \
  -H "x-api-key: $KONNECT_API_KEY"

Exemple : 200

[
  {
    "id": "id",
    "organisationId": "org_01J9Z3K4EXAMPLE0000000000",
    "name": "name",
    "slug": "online-shop",
    "displayName": "displayName",
    "logoFileId": "logoFileId",
    "themeColor": "#1a2b3c",
    "successUrl": "successUrl",
    "failUrl": "failUrl",
    "status": "active",
    "isDefault": true,
    "archivedAt": "2026-10-01T09:30:00.000Z",
    "routes": [
      {
        "provider": "clictopay",
        "label": "default",
        "affiliationId": "affiliationId",
        "affiliationStatus": "draft"
      }
    ],
    "acceptedProviders": [
      "clictopay"
    ],
    "createdAt": "2026-10-01T09:30:00.000Z",
    "updatedAt": "2026-10-01T09:30:00.000Z"
  }
]

Create a payment account (a collection point of the organisation)

POST/organisations/{id}/payment-accountsSession du tableau de bord

Paramètres

idstringpathobligatoire

Corps de la requête application/json

displayNamestring | null
logoFileIdstring (uuid) | null
A file of this organisation (upload it first with type logo)
themeColorstring | null
successUrlstring | null
failUrlstring | null
namestringobligatoire
slugstring
Derived from name when omitted

Réponses

201
- idstring (uuid)obligatoire
- organisationIdstring (uuid)obligatoire
- namestringobligatoire
- slugstringobligatoire
- displayNamestring | nullobligatoire
  Checkout name; null uses name
- logoFileIdstring (uuid) | nullobligatoire
- themeColorstring | nullobligatoire
- successUrlstring | nullobligatoire
- failUrlstring | nullobligatoire
- statusstringobligatoire
  - enum: "active", "paused", "archived"
- isDefaultbooleanobligatoire
- archivedAtstring (date-time) | nullobligatoire
- routesRouteDto[]obligatoire
  - providerstringobligatoire
    - enum: "clictopay", "flouci", "izi", "mpgs_poste", "pluxee", "kashy", "enda_tao"
  - labelstringobligatoire
  - affiliationIdstring (uuid)obligatoire
  - affiliationStatusstringobligatoire
    Status of the affiliation; only active ones make the provider accepted
    - enum: "draft", "verifying", "active", "suspended", "revoked", "unknown"
- acceptedProvidersstring[]obligatoire
  Providers with an active routed affiliation; empty unless the account is active
- createdAtstring (date-time)obligatoire
- updatedAtstring (date-time)obligatoire

Exemples de code

curl -X POST "$KONNECT_API_URL/organisations/id/payment-accounts" \
  -H "Cookie: konnect_session=$KONNECT_SESSION" \
  -H "Content-Type: application/json" \
  -d '{
  "displayName": "Test shop",
  "logoFileId": "logoFileId",
  "themeColor": "#1a2b3c",
  "successUrl": "https://shop.example.test/ok",
  "failUrl": "https://shop.example.test/ko",
  "name": "Online shop",
  "slug": "online-shop"
}'

Exemple : corps de la requête

{
  "displayName": "Test shop",
  "logoFileId": "logoFileId",
  "themeColor": "#1a2b3c",
  "successUrl": "https://shop.example.test/ok",
  "failUrl": "https://shop.example.test/ko",
  "name": "Online shop",
  "slug": "online-shop"
}

Exemple : 201

{
  "id": "id",
  "organisationId": "org_01J9Z3K4EXAMPLE0000000000",
  "name": "name",
  "slug": "online-shop",
  "displayName": "displayName",
  "logoFileId": "logoFileId",
  "themeColor": "#1a2b3c",
  "successUrl": "successUrl",
  "failUrl": "failUrl",
  "status": "active",
  "isDefault": true,
  "archivedAt": "2026-10-01T09:30:00.000Z",
  "routes": [
    {
      "provider": "clictopay",
      "label": "default",
      "affiliationId": "affiliationId",
      "affiliationStatus": "draft"
    }
  ],
  "acceptedProviders": [
    "clictopay"
  ],
  "createdAt": "2026-10-01T09:30:00.000Z",
  "updatedAt": "2026-10-01T09:30:00.000Z"
}

One payment account

GET/organisations/{id}/payment-accounts/{accountId}Clé API

Paramètres

idstringpathobligatoire
accountIdstringpathobligatoire

Réponses

200
- idstring (uuid)obligatoire
- organisationIdstring (uuid)obligatoire
- namestringobligatoire
- slugstringobligatoire
- displayNamestring | nullobligatoire
  Checkout name; null uses name
- logoFileIdstring (uuid) | nullobligatoire
- themeColorstring | nullobligatoire
- successUrlstring | nullobligatoire
- failUrlstring | nullobligatoire
- statusstringobligatoire
  - enum: "active", "paused", "archived"
- isDefaultbooleanobligatoire
- archivedAtstring (date-time) | nullobligatoire
- routesRouteDto[]obligatoire
  - providerstringobligatoire
    - enum: "clictopay", "flouci", "izi", "mpgs_poste", "pluxee", "kashy", "enda_tao"
  - labelstringobligatoire
  - affiliationIdstring (uuid)obligatoire
  - affiliationStatusstringobligatoire
    Status of the affiliation; only active ones make the provider accepted
    - enum: "draft", "verifying", "active", "suspended", "revoked", "unknown"
- acceptedProvidersstring[]obligatoire
  Providers with an active routed affiliation; empty unless the account is active
- createdAtstring (date-time)obligatoire
- updatedAtstring (date-time)obligatoire

Exemples de code

curl -X GET "$KONNECT_API_URL/organisations/id/payment-accounts/accountId" \
  -H "x-api-key: $KONNECT_API_KEY"

Exemple : 200

{
  "id": "id",
  "organisationId": "org_01J9Z3K4EXAMPLE0000000000",
  "name": "name",
  "slug": "online-shop",
  "displayName": "displayName",
  "logoFileId": "logoFileId",
  "themeColor": "#1a2b3c",
  "successUrl": "successUrl",
  "failUrl": "failUrl",
  "status": "active",
  "isDefault": true,
  "archivedAt": "2026-10-01T09:30:00.000Z",
  "routes": [
    {
      "provider": "clictopay",
      "label": "default",
      "affiliationId": "affiliationId",
      "affiliationStatus": "draft"
    }
  ],
  "acceptedProviders": [
    "clictopay"
  ],
  "createdAt": "2026-10-01T09:30:00.000Z",
  "updatedAt": "2026-10-01T09:30:00.000Z"
}

Edit name, slug, branding, URLs; pause, resume or make default

PATCH/organisations/{id}/payment-accounts/{accountId}Session du tableau de bord

Paramètres

idstringpathobligatoire
accountIdstringpathobligatoire

Corps de la requête application/json

displayNamestring | null
logoFileIdstring (uuid) | null
A file of this organisation (upload it first with type logo)
themeColorstring | null
successUrlstring | null
failUrlstring | null
namestring
slugstring
statusstring
Pause or resume; archiving has its own route
- enum: "active", "paused"
isDefaultnumber
Make this account the default one (the previous default stops being it)
- enum: true

Réponses

200
- idstring (uuid)obligatoire
- organisationIdstring (uuid)obligatoire
- namestringobligatoire
- slugstringobligatoire
- displayNamestring | nullobligatoire
  Checkout name; null uses name
- logoFileIdstring (uuid) | nullobligatoire
- themeColorstring | nullobligatoire
- successUrlstring | nullobligatoire
- failUrlstring | nullobligatoire
- statusstringobligatoire
  - enum: "active", "paused", "archived"
- isDefaultbooleanobligatoire
- archivedAtstring (date-time) | nullobligatoire
- routesRouteDto[]obligatoire
  - providerstringobligatoire
    - enum: "clictopay", "flouci", "izi", "mpgs_poste", "pluxee", "kashy", "enda_tao"
  - labelstringobligatoire
  - affiliationIdstring (uuid)obligatoire
  - affiliationStatusstringobligatoire
    Status of the affiliation; only active ones make the provider accepted
    - enum: "draft", "verifying", "active", "suspended", "revoked", "unknown"
- acceptedProvidersstring[]obligatoire
  Providers with an active routed affiliation; empty unless the account is active
- createdAtstring (date-time)obligatoire
- updatedAtstring (date-time)obligatoire

Exemples de code

curl -X PATCH "$KONNECT_API_URL/organisations/id/payment-accounts/accountId" \
  -H "Cookie: konnect_session=$KONNECT_SESSION" \
  -H "Content-Type: application/json" \
  -d '{
  "displayName": "Test shop",
  "logoFileId": "logoFileId",
  "themeColor": "#1a2b3c",
  "successUrl": "https://shop.example.test/ok",
  "failUrl": "https://shop.example.test/ko",
  "name": "name",
  "slug": "slug",
  "status": "active",
  "isDefault": true
}'

Exemple : corps de la requête

{
  "displayName": "Test shop",
  "logoFileId": "logoFileId",
  "themeColor": "#1a2b3c",
  "successUrl": "https://shop.example.test/ok",
  "failUrl": "https://shop.example.test/ko",
  "name": "name",
  "slug": "slug",
  "status": "active",
  "isDefault": true
}

Exemple : 200

{
  "id": "id",
  "organisationId": "org_01J9Z3K4EXAMPLE0000000000",
  "name": "name",
  "slug": "online-shop",
  "displayName": "displayName",
  "logoFileId": "logoFileId",
  "themeColor": "#1a2b3c",
  "successUrl": "successUrl",
  "failUrl": "failUrl",
  "status": "active",
  "isDefault": true,
  "archivedAt": "2026-10-01T09:30:00.000Z",
  "routes": [
    {
      "provider": "clictopay",
      "label": "default",
      "affiliationId": "affiliationId",
      "affiliationStatus": "draft"
    }
  ],
  "acceptedProviders": [
    "clictopay"
  ],
  "createdAt": "2026-10-01T09:30:00.000Z",
  "updatedAt": "2026-10-01T09:30:00.000Z"
}

Archive a payment account (terminal; never the default account)

POST/organisations/{id}/payment-accounts/{accountId}/archiveSession du tableau de bord

Paramètres

idstringpathobligatoire
accountIdstringpathobligatoire

Réponses

200
- idstring (uuid)obligatoire
- organisationIdstring (uuid)obligatoire
- namestringobligatoire
- slugstringobligatoire
- displayNamestring | nullobligatoire
  Checkout name; null uses name
- logoFileIdstring (uuid) | nullobligatoire
- themeColorstring | nullobligatoire
- successUrlstring | nullobligatoire
- failUrlstring | nullobligatoire
- statusstringobligatoire
  - enum: "active", "paused", "archived"
- isDefaultbooleanobligatoire
- archivedAtstring (date-time) | nullobligatoire
- routesRouteDto[]obligatoire
  - providerstringobligatoire
    - enum: "clictopay", "flouci", "izi", "mpgs_poste", "pluxee", "kashy", "enda_tao"
  - labelstringobligatoire
  - affiliationIdstring (uuid)obligatoire
  - affiliationStatusstringobligatoire
    Status of the affiliation; only active ones make the provider accepted
    - enum: "draft", "verifying", "active", "suspended", "revoked", "unknown"
- acceptedProvidersstring[]obligatoire
  Providers with an active routed affiliation; empty unless the account is active
- createdAtstring (date-time)obligatoire
- updatedAtstring (date-time)obligatoire

Exemples de code

curl -X POST "$KONNECT_API_URL/organisations/id/payment-accounts/accountId/archive" \
  -H "Cookie: konnect_session=$KONNECT_SESSION"

Exemple : 200

{
  "id": "id",
  "organisationId": "org_01J9Z3K4EXAMPLE0000000000",
  "name": "name",
  "slug": "online-shop",
  "displayName": "displayName",
  "logoFileId": "logoFileId",
  "themeColor": "#1a2b3c",
  "successUrl": "successUrl",
  "failUrl": "failUrl",
  "status": "active",
  "isDefault": true,
  "archivedAt": "2026-10-01T09:30:00.000Z",
  "routes": [
    {
      "provider": "clictopay",
      "label": "default",
      "affiliationId": "affiliationId",
      "affiliationStatus": "draft"
    }
  ],
  "acceptedProviders": [
    "clictopay"
  ],
  "createdAt": "2026-10-01T09:30:00.000Z",
  "updatedAt": "2026-10-01T09:30:00.000Z"
}

Affiliation used per provider, and the accepted providers

GET/organisations/{id}/payment-accounts/{accountId}/routingClé API

Paramètres

idstringpathobligatoire
accountIdstringpathobligatoire

Réponses

200
- paymentAccountIdstring (uuid)obligatoire
- routesRouteDto[]obligatoire
  - providerstringobligatoire
    - enum: "clictopay", "flouci", "izi", "mpgs_poste", "pluxee", "kashy", "enda_tao"
  - labelstringobligatoire
  - affiliationIdstring (uuid)obligatoire
  - affiliationStatusstringobligatoire
    Status of the affiliation; only active ones make the provider accepted
    - enum: "draft", "verifying", "active", "suspended", "revoked", "unknown"
- acceptedProvidersstring[]obligatoire

Exemples de code

curl -X GET "$KONNECT_API_URL/organisations/id/payment-accounts/accountId/routing" \
  -H "x-api-key: $KONNECT_API_KEY"

Exemple : 200

{
  "paymentAccountId": "paymentAccountId",
  "routes": [
    {
      "provider": "clictopay",
      "label": "default",
      "affiliationId": "affiliationId",
      "affiliationStatus": "draft"
    }
  ],
  "acceptedProviders": [
    "clictopay"
  ]
}

Route providers to affiliations of this organisation (null removes a route); revoked affiliations and affiliations of another organisation are refused

PUT/organisations/{id}/payment-accounts/{accountId}/routingSession du tableau de bord

Paramètres

idstringpathobligatoire
accountIdstringpathobligatoire

Corps de la requête application/json

routesRouteChangeDto[]obligatoire
Changes per provider; providers not listed keep their routing
- providerstringobligatoire
  - enum: "clictopay", "flouci", "izi", "mpgs_poste", "pluxee", "kashy", "enda_tao"
- labelstring
  Label of the route. With an affiliation, it must match the affiliation label (taken from it when omitted). With null, omitting it removes every route of the provider.
- affiliationIdstring (uuid) | nullobligatoire
  Affiliation to use, or null to stop routing this provider

Réponses

200
- paymentAccountIdstring (uuid)obligatoire
- routesRouteDto[]obligatoire
  - providerstringobligatoire
    - enum: "clictopay", "flouci", "izi", "mpgs_poste", "pluxee", "kashy", "enda_tao"
  - labelstringobligatoire
  - affiliationIdstring (uuid)obligatoire
  - affiliationStatusstringobligatoire
    Status of the affiliation; only active ones make the provider accepted
    - enum: "draft", "verifying", "active", "suspended", "revoked", "unknown"
- acceptedProvidersstring[]obligatoire

Exemples de code

curl -X PUT "$KONNECT_API_URL/organisations/id/payment-accounts/accountId/routing" \
  -H "Cookie: konnect_session=$KONNECT_SESSION" \
  -H "Content-Type: application/json" \
  -d '{
  "routes": [
    {
      "provider": "clictopay",
      "label": "default",
      "affiliationId": "affiliationId"
    }
  ]
}'

Exemple : corps de la requête

{
  "routes": [
    {
      "provider": "clictopay",
      "label": "default",
      "affiliationId": "affiliationId"
    }
  ]
}

Exemple : 200

{
  "paymentAccountId": "paymentAccountId",
  "routes": [
    {
      "provider": "clictopay",
      "label": "default",
      "affiliationId": "affiliationId",
      "affiliationStatus": "draft"
    }
  ],
  "acceptedProviders": [
    "clictopay"
  ]
}