providers

Version 0.1.03 opérations

Enabled providers with their credential schemas (fields, never values)

GET/providers

Paramètres

Aucun paramètre.

Réponses

200
- codestringobligatoire
- namestringobligatoire
- enabledbooleanobligatoire
- capabilitiesProviderCapabilitiesDtoobligatoire
  - initbooleanobligatoire
  - statusbooleanobligatoire
  - callbackbooleanobligatoire
  - refundbooleanobligatoire
  - statementbooleanobligatoire
  - verifyCredentialsbooleanobligatoire
- credentialSchemaCredentialFieldDto[]obligatoire
  - namestringobligatoire
  - labelstringobligatoire
  - typestringobligatoire
    - enum: "text", "password", "select"
  - secretbooleanobligatoire
    Secret fields are encrypted at rest and never returned by the API.
  - helpstring
  - optionsstring[]
- onboardingGuideOnboardingGuideDtoobligatoire
  - selfstringobligatoire
    Markdown: steps when the merchant applies directly to the provider.
  - viaKonnectstringobligatoire
    Markdown: steps when Konnect handles the application.
  - delaystringobligatoire
  - linksOnboardingLinkDto[]obligatoire
    - labelstringobligatoire
    - urlstringobligatoire
- settlementInfostring | null

Exemples de code

curl -X GET "$KONNECT_API_URL/providers"

Exemple : 200

[
  {
    "code": "clictopay",
    "name": "ClicToPay",
    "enabled": true,
    "capabilities": {
      "init": true,
      "status": true,
      "callback": true,
      "refund": true,
      "statement": true,
      "verifyCredentials": true
    },
    "credentialSchema": [
      {
        "name": "userName",
        "label": "Affiliation login",
        "type": "text",
        "secret": true,
        "help": "help",
        "options": [
          "string"
        ]
      }
    ],
    "onboardingGuide": {
      "self": "self",
      "viaKonnect": "viaKonnect",
      "delay": "5 to 10 working days",
      "links": [
        {
          "label": "label",
          "url": "url"
        }
      ]
    },
    "settlementInfo": "settlementInfo"
  }
]

One enabled provider

GET/providers/{code}

Paramètres

codestringpathobligatoire

Réponses

200
- codestringobligatoire
- namestringobligatoire
- enabledbooleanobligatoire
- capabilitiesProviderCapabilitiesDtoobligatoire
  - initbooleanobligatoire
  - statusbooleanobligatoire
  - callbackbooleanobligatoire
  - refundbooleanobligatoire
  - statementbooleanobligatoire
  - verifyCredentialsbooleanobligatoire
- credentialSchemaCredentialFieldDto[]obligatoire
  - namestringobligatoire
  - labelstringobligatoire
  - typestringobligatoire
    - enum: "text", "password", "select"
  - secretbooleanobligatoire
    Secret fields are encrypted at rest and never returned by the API.
  - helpstring
  - optionsstring[]
- onboardingGuideOnboardingGuideDtoobligatoire
  - selfstringobligatoire
    Markdown: steps when the merchant applies directly to the provider.
  - viaKonnectstringobligatoire
    Markdown: steps when Konnect handles the application.
  - delaystringobligatoire
  - linksOnboardingLinkDto[]obligatoire
    - labelstringobligatoire
    - urlstringobligatoire
- settlementInfostring | null
404Unknown or disabled provider

Exemples de code

curl -X GET "$KONNECT_API_URL/providers/code"

Exemple : 200

{
  "code": "clictopay",
  "name": "ClicToPay",
  "enabled": true,
  "capabilities": {
    "init": true,
    "status": true,
    "callback": true,
    "refund": true,
    "statement": true,
    "verifyCredentials": true
  },
  "credentialSchema": [
    {
      "name": "userName",
      "label": "Affiliation login",
      "type": "text",
      "secret": true,
      "help": "help",
      "options": [
        "string"
      ]
    }
  ],
  "onboardingGuide": {
    "self": "self",
    "viaKonnect": "viaKonnect",
    "delay": "5 to 10 working days",
    "links": [
      {
        "label": "label",
        "url": "url"
      }
    ]
  },
  "settlementInfo": "settlementInfo"
}

Konnect admin: update the published view (enabled, onboardingGuide, settlementInfo)

PATCH/providers/{code}Session du tableau de bord

Capabilities and credential schema come from the connector and are synced at boot; they cannot be set here. Requires a Konnect admin session.

Paramètres

codestringpathobligatoire

Corps de la requête application/json

enabledboolean
onboardingGuideOnboardingGuideDto
- selfstringobligatoire
  Markdown: steps when the merchant applies directly to the provider.
- viaKonnectstringobligatoire
  Markdown: steps when Konnect handles the application.
- delaystringobligatoire
- linksOnboardingLinkDto[]obligatoire
  - labelstringobligatoire
  - urlstringobligatoire
settlementInfostring | null

Réponses

200
- codestringobligatoire
- namestringobligatoire
- enabledbooleanobligatoire
- capabilitiesProviderCapabilitiesDtoobligatoire
  - initbooleanobligatoire
  - statusbooleanobligatoire
  - callbackbooleanobligatoire
  - refundbooleanobligatoire
  - statementbooleanobligatoire
  - verifyCredentialsbooleanobligatoire
- credentialSchemaCredentialFieldDto[]obligatoire
  - namestringobligatoire
  - labelstringobligatoire
  - typestringobligatoire
    - enum: "text", "password", "select"
  - secretbooleanobligatoire
    Secret fields are encrypted at rest and never returned by the API.
  - helpstring
  - optionsstring[]
- onboardingGuideOnboardingGuideDtoobligatoire
  - selfstringobligatoire
    Markdown: steps when the merchant applies directly to the provider.
  - viaKonnectstringobligatoire
    Markdown: steps when Konnect handles the application.
  - delaystringobligatoire
  - linksOnboardingLinkDto[]obligatoire
    - labelstringobligatoire
    - urlstringobligatoire
- settlementInfostring | null
400Invalid body or a field the connector owns
403Not a Konnect admin
404Unknown provider

Exemples de code

curl -X PATCH "$KONNECT_API_URL/providers/code" \
  -H "Cookie: konnect_session=$KONNECT_SESSION" \
  -H "Content-Type: application/json" \
  -d '{
  "enabled": true,
  "onboardingGuide": {
    "self": "self",
    "viaKonnect": "viaKonnect",
    "delay": "5 to 10 working days",
    "links": [
      {
        "label": "label",
        "url": "url"
      }
    ]
  },
  "settlementInfo": "settlementInfo"
}'

Exemple : corps de la requête

{
  "enabled": true,
  "onboardingGuide": {
    "self": "self",
    "viaKonnect": "viaKonnect",
    "delay": "5 to 10 working days",
    "links": [
      {
        "label": "label",
        "url": "url"
      }
    ]
  },
  "settlementInfo": "settlementInfo"
}

Exemple : 200

{
  "code": "clictopay",
  "name": "ClicToPay",
  "enabled": true,
  "capabilities": {
    "init": true,
    "status": true,
    "callback": true,
    "refund": true,
    "statement": true,
    "verifyCredentials": true
  },
  "credentialSchema": [
    {
      "name": "userName",
      "label": "Affiliation login",
      "type": "text",
      "secret": true,
      "help": "help",
      "options": [
        "string"
      ]
    }
  ],
  "onboardingGuide": {
    "self": "self",
    "viaKonnect": "viaKonnect",
    "delay": "5 to 10 working days",
    "links": [
      {
        "label": "label",
        "url": "url"
      }
    ]
  },
  "settlementInfo": "settlementInfo"
}