GET
Profil du marchand connecté

Autorisations

Authorization
string
header
requis

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Réponse

200 - application/json

Profil marchand enrichi du rôle et des permissions effectives.

id
string
requis

Identifiant unique du marchand.

name
string
requis

Raison sociale ou nom commercial du marchand.

email
string
requis

Adresse e-mail principale du compte marchand.

avatarUrl
object | null
requis

Chemin URL relatif de l'avatar courant du marchand. null si aucun avatar n'a été défini.

accountType
enum<string>
requis

Type de compte marchand (business ou personal).

Options disponibles:
business,
personal
country
string
requis

Code ISO du pays de résidence ou d'immatriculation.

phoneNumber
object | null
requis

Numéro de téléphone du compte au format international (E.164).

kybStatus
enum<string>
requis

Statut de vérification d'identité du marchand (not_initiated, pending, approved, rejected, suspended).

Options disponibles:
not_initiated,
pending,
approved,
rejected,
suspended
payoutMode
enum<string>
requis

Mode de gestion des retraits : allow_all autorise n'importe quelle destination, whitelist_only restreint aux adresses pré-approuvées.

Options disponibles:
allow_all,
whitelist_only
disputeManager
enum<string>
requis

Acteur en charge de la résolution des litiges sur les paiements (platform ou merchant).

Options disponibles:
platform,
merchant
payinFeeBearer
enum<string>
requis

Qui supporte les frais de l'encaissement (payin) : merchant (déduits du marchand) ou customer (ajoutés au montant payé par le client).

Options disponibles:
merchant,
customer
payoutFeeBearer
enum<string>
requis

Qui supporte les frais des retraits crypto manuels et remboursements.

Options disponibles:
merchant,
customer
settlementFeeBearer
enum<string>
requis

Qui supporte la commission de plateforme appliquée lors d'un règlement (settlement).

Options disponibles:
merchant,
customer
settlementPayoutFeeBearer
enum<string>
requis

Qui supporte les frais réseau (on-chain) du transfert vers le prestataire de règlement.

Options disponibles:
merchant,
customer
settlementProviderFeeBearer
enum<string>
requis

Qui supporte les frais de conversion appliqués par le prestataire fiat.

Options disponibles:
merchant,
customer
settlementMnoFeeBearer
enum<string>
requis

Qui supporte les frais du rail mobile money / bancaire lors du versement final.

Options disponibles:
merchant,
customer
collectCustomerFeesOnPayment
boolean
requis

SETTLEMENT_FEES §1 Règle #2 — quand true, les frais customer-bearer (settlement OU payout selon la priorité §1) sont pré-collectés au payin via inflation ; quand false (défaut), ils sont déduits du montant à l'exécution.

underpaidThresholdPct
string
requis

Seuil minimal accepté (en %) lors d'un sous-paiement. Sérialisé en chaîne décimale.

overpaidThresholdPct
object | null
requis

Seuil maximal accepté (en %) lors d'un sur-paiement. Sérialisé en chaîne décimale. null si non défini.

isFrozen
boolean
requis

Indique si le compte est gelé (toute opération sortante est suspendue).

currency
string
requis

Devise fiat de référence du compte marchand (code ISO 4217).

createdAt
string
requis

Date de création du compte marchand — ISO 8601.

firstName
object | null
requis

Prénom de l'utilisateur connecté (membre du compte marchand). null si non renseigné.

lastName
object | null
requis

Nom de l'utilisateur connecté (membre du compte marchand). null si non renseigné.

role
string
requis

Rôle de l'utilisateur connecté sur ce compte marchand (owner, admin, developer, finance, viewer, cashier).

permissions
string[]
requis

Permissions effectives de l'utilisateur connecté. Pour un owner (ou en l'absence d'utilisateur secondaire), la sentinelle ["*"] est renvoyée pour signifier un accès complet.

Exemple:
settlementsEnabled
boolean
requis

Toggle plateforme global des reversements (settlements). Quand false, ce marchand ne peut pas initier de reversement (l'API le rejette) et le dashboard masque le menu Reversement ainsi que la configuration des fee bearers settlement.