# Fiche connecteur BlueSnap Catalogue Pipedream : connexion du compte et droits nécessaires. Les actions réellement utilisables sont vérifiées dans Bruno lors de la connexion. Les déclencheurs sont documentés à titre de référence et ne sont pas activés automatiquement dans Bruno. Les noms et données des exemples sont fictifs ; toute exécution reste soumise aux droits et aux validations du connecteur. ## BlueSnap URL : https://get-bruno.com/features/connectors/bluesnap Référence texte : https://get-bruno.com/features/connectors/bluesnap/reference.txt Origine : Catalogue Pipedream Statut : Catalogue Pipedream — connexion à vérifier Catégories : Commerce Description : BlueSnap est une plateforme de traitement des paiements. Le connecteur couvre la création de clients enregistrés, la création de transactions, la consultation des transactions et la gestion de remboursements ou de fiches client enregistrées. Authentification : API key Présentation : BlueSnap est une plateforme de traitement des paiements. Le connecteur couvre la création de clients enregistrés, la création de transactions, la consultation des transactions et la gestion de remboursements ou de fiches client enregistrées. Usage : Créer un client enregistré avant un futur débit Exemple de demande : Je veux enregistrer le client Atelier Martin comme client conservé pour pouvoir utiliser sa carte plus tard. Résultat attendu : Une fiche de client enregistré est créée et un vaultedShopperId est renvoyé pour les opérations suivantes. À préciser : Nom du client, par exemple Atelier Martin ; Coordonnées de facturation du client ; Moyen de paiement à enregistrer si nécessaire Nature : Exemple sous réserve de connexion et de droits Sources de l’exemple : https://pipedream.com/apps/bluesnap/actions/create-vaulted-shopper Usage : Débiter une commande réglée par carte Exemple de demande : Je veux créer un débit AUTH_CAPTURE pour la commande de l’atelier Martin avec la carte du client. Résultat attendu : Une transaction de paiement peut être créée à partir des données de carte ou d’un vaultedShopperId existant. À préciser : Montant à débiter ; Données de carte ou vaultedShopperId ; Référence de la commande, par exemple commande Atelier Martin Nature : Exemple sous réserve de connexion et de droits Sources de l’exemple : https://pipedream.com/apps/bluesnap/actions/create-transaction ; https://pipedream.com/apps/bluesnap/actions/create-vaulted-shopper Usage : Vérifier une transaction et préparer un remboursement Exemple de demande : Je veux retrouver la transaction de la commande Atelier Martin puis vérifier si elle doit être remboursée en totalité ou en partie. Résultat attendu : Une transaction peut être récupérée par son identifiant, puis un remboursement peut être préparé à partir de cet identifiant. À préciser : Identifiant de transaction ou consultation des transactions ; Montant à rembourser si remboursement partiel ; Contexte de la commande, par exemple Atelier Martin Nature : Exemple sous réserve de connexion et de droits Sources de l’exemple : https://pipedream.com/apps/bluesnap/actions/get-transaction ; https://pipedream.com/apps/bluesnap/actions/list-transactions ; https://pipedream.com/apps/bluesnap/actions/refund-transaction Limites propres au service : La liste des transactions est issue du reporting et peut être retardée d’environ une heure. La consultation d’un client enregistré exige un vaultedShopperId déjà connu. Aucune liste globale de clients enregistrés n’est documentée. Pour retrouver un identifiant de transaction, il faut passer par la liste des transactions ou une transaction déjà connue. Vocabulaire français : Créer une transaction — Débite une carte ou un client enregistré en créant une transaction AUTH_CAPTURE dans BlueSnap. (https://pipedream.com/apps/bluesnap/actions/create-transaction) Vocabulaire français : Créer un client enregistré — Crée une fiche de client conservé et renvoie un vaultedShopperId réutilisable. (https://pipedream.com/apps/bluesnap/actions/create-vaulted-shopper) Vocabulaire français : Obtenir une transaction — Récupère une transaction BlueSnap à partir de son identifiant. (https://pipedream.com/apps/bluesnap/actions/get-transaction) Vocabulaire français : Obtenir un client enregistré — Récupère un client conservé à partir de son identifiant et renvoie ses détails connus. (https://pipedream.com/apps/bluesnap/actions/get-vaulted-shopper) Vocabulaire français : Lister les transactions — Liste les transactions BlueSnap via l’API de reporting, avec pagination si nécessaire. (https://pipedream.com/apps/bluesnap/actions/list-transactions) Vocabulaire français : Rembourser une transaction — Rembourse une transaction BlueSnap en totalité ou en partie selon le montant fourni. (https://pipedream.com/apps/bluesnap/actions/refund-transaction) Vocabulaire français : Mettre à jour un client enregistré — Met à jour une fiche de client conservé existante. (https://pipedream.com/apps/bluesnap/actions/update-vaulted-shopper) - action : Create Transaction — Charge a card or vaulted shopper by creating an AUTH_CAPTURE transaction in BlueSnap. Provide either raw credit card fields or a vaultedShopperId. Use Create Vaulted Shopper first to obtain a vaultedShopperId for stored-card charges. See the documentation (https://pipedream.com/apps/bluesnap/actions/create-transaction) - action : Create Vaulted Shopper — Create a vaulted shopper (stored customer) record in BlueSnap. Returns a vaultedShopperId usable in Create Transaction , Get Vaulted Shopper , and Update Vaulted Shopper . See the documentation (https://pipedream.com/apps/bluesnap/actions/create-vaulted-shopper) - action : Get Transaction — Retrieve a single BlueSnap transaction by ID. Use List Transactions first to find a transaction ID. See the documentation (https://pipedream.com/apps/bluesnap/actions/get-transaction) - action : Get Vaulted Shopper — Retrieve a vaulted shopper (stored customer) by ID, including their billing contact details and stored payment sources. The vaultedShopperId is returned by Create Vaulted Shopper or found on a transaction record; BlueSnap does not expose a list-all-shoppers endpoint. See the documentation (https://pipedream.com/apps/bluesnap/actions/get-vaulted-shopper) - action : List Transactions — List BlueSnap transactions via the Reporting API. Report data is delayed by about one hour, so transactions from the last hour may not appear yet (use Get Transaction for a just-created transaction). Returns transaction summaries whose Invoice ID field is the transactionId usable in Get Transaction and Refund Transaction . The output includes totalRowCount and, when more rows remain, a nextPageToken to pass back into this action for the next page. See the documentation (https://pipedream.com/apps/bluesnap/actions/list-transactions) - action : Refund Transaction — Refund a BlueSnap transaction. Omit amount for a full refund or supply a partial amount. Use List Transactions first to find the transaction ID. See the documentation (https://pipedream.com/apps/bluesnap/actions/refund-transaction) - action : Update Vaulted Shopper — Update an existing vaulted shopper. The vaultedShopperId is returned by Create Vaulted Shopper or a transaction response; BlueSnap does not expose a list-all-shoppers endpoint. See the documentation (https://pipedream.com/apps/bluesnap/actions/update-vaulted-shopper)