Référence API

Configurer un moyen de paiement approuvé

Crée une configuration de paiement sous permission et politique d’approbation ; n’active pas de prestataires arbitraires.

POSThttps://api.sparkglim.net/api/white-label/portal/reseller/payment-methods

Modèle d’accès

Modèle d’accès: Session SparkGlim et permissions de membre
Portée requise: payments:write
Disponibilité documentée: Implémenté dans le code

La disponibilité est vérifiée dans le code, pas garantie en production.

Utilisez le parcours de membre d’équipe Créateur. La revente ne donne jamais accès illimité à la base ou à l’administration.

En-têtes

Nom	Type	Validation
`Authorization`Obligatoire Session Bearer SparkGlim existante ; appartenance et capacités attribuées autorisent chaque opération côté serveur.	`string`	Validation : Jeton Bearer d’une session authentifiée existante.

Requête

Nom	Type	Validation
`providerType`Obligatoire Configuration approuvée du paiement revendeur ; les détails sensibles restent protégés par le serveur.	`enum`	Validation : paystack \| expresspay \| hubtel \| manual.
`methodType`Obligatoire Configuration approuvée du paiement revendeur ; les détails sensibles restent protégés par le serveur.	`enum`	Validation : bank \| mobile_money \| card \| wallet.
`ownerMemberId`Facultatif Relation ou révision du compte existante ; propriété et capacités sont vérifiées côté serveur.	`string\|null`	Validation : UUID.
`ownerCreatorId`Facultatif Relation ou révision du compte existante ; propriété et capacités sont vérifiées côté serveur.	`string\|null`	Validation : UUID.
`label`Facultatif Configuration approuvée du paiement revendeur ; les détails sensibles restent protégés par le serveur.	`string\|null`	Validation : <=120.
`publicDetails`Facultatif Configuration approuvée du paiement revendeur ; les détails sensibles restent protégés par le serveur.	`object`	Validation : Objet JSON.
`encryptedDetails`Facultatif Configuration approuvée du paiement revendeur ; les détails sensibles restent protégés par le serveur.	`object`	Validation : Configuration protégée côté serveur ; ne jamais publier les identifiants d’accès.
`metadata`Facultatif Métadonnées JSON supplémentaires acceptées ; elles ne remplacent jamais autorisation, prix ou propriété.	`object`	Validation : Objet JSON.

Requête

Les exemples décrivent le contrat et ne sont pas exécutés. Utilisez des données de test autorisées ; ne saisissez jamais de secret réel ici.

POST /api/white-label/portal/reseller/payment-methods

http

POST /api/white-label/portal/reseller/payment-methods HTTP/1.1
Host: api.sparkglim.net
Authorization: Bearer <EXISTING_SESSION_TOKEN>
Content-Type: application/json

{
  "providerType": "manual",
  "methodType": "bank",
  "label": "Example approved method"
}

Réponse

Réponse de succès · HTTP 201

json

{
  "success": true,
  "data": {
    "id": "11111111-1111-4111-8111-111111111111",
    "status": "pending"
  }
}

Réponse d’erreur · HTTP 400

json

{
  "success": false,
  "error": "<ERROR_MESSAGE>"
}

Validation, permissions, données indisponibles et pannes utilisent le statut HTTP et l’erreur du gestionnaire.

Limites et tentatives

Limite serveur par défaut : 100 requêtes par IP sur 60 secondes. Des contrôles spécifiques s’appliquent.

Compatibilité du code

Les opérations autorisées nécessitent des tests propres au compte.

server/src/api/router.ts
server/src/api/routes/white-label.ts
server/src/white-label/reseller-service.ts
server/src/white-label/schemas.ts

Modèle d’accès

En-têtes

Requête

Requête

Réponse

Limites et tentatives

Compatibilité du code

Poursuivre le développement