Authentification

PayRouter utilise l'authentification par jeton. Chaque requête authentifiée envoie un jeton dans l'en-tête Authorization avec le schéma Bearer :

Authorization: Bearer <your-token>

Seuls l'inscription, la vérification d'e-mail, la réinitialisation de mot de passe et les webhooks des fournisseurs sont non authentifiés. Tout le reste requiert un jeton valide.

1. S'inscrire & vérifier votre e-mail

Créez un compte, puis confirmez l'OTP à 6 chiffres qui vous est envoyé par e-mail.

# Step 1 — sign up
curl -X POST https://payrouter.io/api/auth/signup/ \
  -H "Content-Type: application/json" \
  -d '{
    "email": "you@example.com",
    "password": "S0me-Str0ng-Pass",
    "password2": "S0me-Str0ng-Pass",
    "first_name": "Jane",
    "last_name": "Doe"
  }'

# Step 2 — confirm the OTP sent to your inbox
curl -X POST https://payrouter.io/api/auth/verify-email/ \
  -H "Content-Type: application/json" \
  -d '{ "email": "you@example.com", "otp": "123456" }'

import requests

requests.post("https://payrouter.io/api/auth/signup/", json={
    "email": "you@example.com",
    "password": "S0me-Str0ng-Pass",
    "password2": "S0me-Str0ng-Pass",
    "first_name": "Jane",
    "last_name": "Doe",
})

# After receiving the OTP by email:
res = requests.post("https://payrouter.io/api/auth/verify-email/", json={
    "email": "you@example.com",
    "otp": "123456",
})
print(res.json()["token"])

Champs de la requête d'inscription

L'inscription renvoie un temp_key et envoie l'OTP par e-mail. Verify-email le confirme et renvoie votre premier jeton ainsi que votre profil utilisateur. Si l'OTP a expiré, demandez-en un nouveau avec POST /api/auth/resend-otp/ ({ "email": "…" }).

2. Se connecter (jeton de session)

Échangez e-mail + mot de passe contre un jeton :

curl -X POST https://payrouter.io/api/auth/token/ \
  -H "Content-Type: application/json" \
  -d '{ "email": "you@example.com", "password": "S0me-Str0ng-Pass" }'

res = requests.post("https://payrouter.io/api/auth/token/", json={
    "email": "you@example.com",
    "password": "S0me-Str0ng-Pass",
})
token = res.json()["token"]

{
  "access": "9a8b7c6d5e…",
  "token": "9a8b7c6d5e…",
  "user": {
    "id": "0b1f…",
    "email": "you@example.com",
    "type": "merchant",
    "account_type": "sandbox",
    "profile_completed": true,
    "has_wallet": true,
    "is_staff": false
  }
}

access et token sont la même valeur — utilisez l'un ou l'autre comme jeton Bearer. Récupérez l'utilisateur courant à tout moment avec GET /api/auth/me/, et mettez à jour votre propre profil (phone, first_name, last_name) avec PATCH /api/auth/me/.

3. Clés API (jetons à longue durée de vie) {#api-keys}

Pour les intégrations serveur à serveur, générez un jeton API dédié qui ne dépend pas d'une connexion interactive. Dans le tableau de bord : Profil → Clés API → Générer un nouveau jeton (vous devez ressaisir votre mot de passe pour confirmer). Via l'API :

curl -X POST https://payrouter.io/api/auth/login-tokens/ \
  -H "Authorization: Bearer $SESSION_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "password": "S0me-Str0ng-Pass" }'

res = requests.post(
    "https://payrouter.io/api/auth/login-tokens/",
    headers={"Authorization": f"Bearer {session_token}"},
    json={"password": "S0me-Str0ng-Pass"},
)
print(res.json()["token"])  # shown once — store securely

{
  "token": "f8849564a1b2c3…",
  "token_key": "f8849564",
  "expiry": "2026-09-25T19:00:25Z"
}

• Lister vos jetons : GET /api/auth/login-tokens/
• Révoquer l'un d'eux : DELETE /api/auth/login-tokens/<token_key>/

Se déconnecter

Révoquez le jeton de la requête courante :

POST /api/auth/logout/
Authorization: Bearer <token>