Aller au contenu

Administration Gift Card

Contrôleur HTTP des actions d'administration sur les cartes cadeaux investisseurs (consultation, remboursement). Source : gift-card.controller.ts.

Tous les endpoints requièrent une session admin BetterAuth valide (AdminAuthGuard).

GET /administration/gift-card/investor/:investorId

Liste les cartes cadeaux d'un investisseur (achetées et reçues).

Source : gift-card.controller.ts#L29.

Path param

  • investorId — UUIDv4

Response

Tableau de cartes cadeaux (cf. GiftCardRepository.getGiftCardsOfInvestor).

POST /administration/gift-card/refund

Rembourse une carte cadeau (annule la transaction P2P et crédite/débite les wallets concernés). Trace l'action via AdminAction (GIFT_CARD_REFUND).

Source : gift-card.controller.ts#L39.

Pré-conditions

  • La carte cadeau doit exister, ne pas être déjà remboursée, ni expirée
  • La transaction P2P d'achat de la carte cadeau doit être au statut succeeded

Request body

{
  "giftCardId": "uuid",
  "refundReason": "Demande client"
}

Validé via refundGiftCardPayload (depuis @bricks-common/api-communication-bricksoffice).

Erreurs

Code Statut Cause
gift-card-not-found 400 Carte cadeau introuvable
gift-card-already-refunded 400 Carte cadeau déjà remboursée
gift-card-expired 400 Carte cadeau expirée
gift-card.p2p-not-succeeded 400 La transaction P2P d'achat n'est pas au statut succeeded
gift-card-claimer-has-not-enough-gift-balance 400 Le bénéficiaire n'a plus assez de gift balance pour qu'on récupère le solde

Liens