Gérer l'inscription de vos clients

Obtenir un lien pour que votre client finalise son inscription

Une fois que vous avez créé une société et fourni les documents vous pouvez récupérer un lien à transmettre à votre client afin qu'il puisse finaliser son inscription et signer son contrat.

Utiliser l'endpoint GET /subscription-link?company=<comp> pour obtenir un lien permettant à votre client de finaliser son inscription :

import requests

url = "https://api-partners.stancer.com/api/partners/subscription-link?company=comp_F5isBBWYDOSnaHhYRc1ZNtF7"

payload = {}
headers = {}

response = requests.request("GET", url, headers=headers, data=payload)

print(response.json())

Réponse :

{
  "link": "https://manage.stancer.com/fr/partner-sign-up?key=FFbiofTfKD9eO6tMzSOvMUznlY7Kp2"
}

Vérifier la progression d'une société

Utiliser l'endpoint GET /registration-progress?company=<comp> pour obtenir la progression d'une société.

Changer le statut d'une société

Cet endpoint est disponible en mode sandbox uniquement.

Voici la liste des statuts que vous pouvez utiliser :

Code	Description
notComplete	L'inscription n'est pas finalisée, l'utilisateur n'a pas encore signé son contrat.
pendingActivation	L'utilisateur a signé son contrat, son dossier est en cours de validation par nos équipes.
validated	Le dossier de l'utilisateur est validé, les clés d'API et les contrats monétiques ne sont pas encore activés.
available	Le compte du client est actif, les clés d'API et les contrats monétiques sont maintenant activés.
pendingDeactivation	La société est en attente de désactivation, soit par une demande de résiliation du client ou d'un rejet du dossier par nos équipes.
deactivate	La société a été désactivée soit par une demande de résiliation du client ou d'un rejet du dossier par nos équipes.

Utiliser l'endpoint PATCH /company-status?company=<comp> pour changer le statut d'une société.

Payload JSON

{
  "status": "available"
}

import requests

url = "https://api-partners.stancer.com/api/partners/company-status?company=comp_F5isBBWYDOSnaHhYRc1ZNtF7"

payload = json.dumps({
  "status": "available"
})
headers = {
  'Content-Type': 'application/json'
}

response = requests.request("PATCH", url, headers=headers, data=payload)

print(response.json())

Réponse :

{
    ...
    "id": "comp_F5isBBWYDOSnaHhYRc1ZNtF7",
    ...
    "status": "available",
    ...
}

Obtenir le changement de statut des sociétés sur une période donnée

Si vous souhaitez savoir si votre client a passé notre KYC ou a été rejeté, vous pouvez utiliser l'endpoint GET /company-status-history?since=<date>&until=<date>&status=<company-status>.

• since est inclusif
• until est exclusif

Pour avoir les changements de statuts du 6 Mai il faut passer la date du 2024-05-06 au since et celle du 2024-05-07 au until.

Cet endpoint vous renverra le changement de statut le plus récent de vos sociétés.

import requests

url = "https://manage.stancer.com/api/partners/company-status-history?since=2024-05-06&until=2024-05-07"

payload = {}
headers = {}

response = requests.request("GET", url, headers=headers, data=payload)

print(response.json())

Réponse :

[
  {
    "date-update": "2024-05-06",
    "id": "comp_QGacA9Lc9Ei4RAEgDkhPlCDR",
    "status": "pendingActivation"
  },
  {
    "date-update": "2024-05-06",
    "id": "comp_F5isBBWYDOSnaHhYRc1ZNtF7",
    "status": "available"
  },
  {
    "date-update": "2024-05-06",
    "id": "comp_y2LXfWd9rZ7p3QtVyDBbNqp0",
    "status": "deactivate",
    "terminated-by-stancer": true
  }
]

Vous pouvez également passer le paramètre status si vous souhaitez obtenir uniquement les sociétés passées dans un statut spécifique durant une période.

Vous pouvez voir les statuts et leurs descriptions dans le Référentiel des statuts d'une société.