Envoyer les détails des transactions depuis Braintree
Quaderno génère automatiquement vos factures et notes de crédit avec les informations client reçues de Braintree, qui récupère à son tour les données collectées par la plateforme que vous utilisez pour gérer vos ventes.
Cet article explique comment personnaliser les informations que Braintree envoie à Quaderno. Ces informations sont utiles aux intégrateurs et aux développeurs.
Dans les cas où certaines informations sont manquantes sur vos documents, veuillez consulter la documentation développeur de Braintree ou contacter le support technique de votre plateforme tierce pour obtenir de l’aide.
Personnaliser les informations de facturation du client
Si vous souhaitez personnaliser les informations de facturation sur vos factures, vous pouvez le faire à l’aide des objets billing_address
et custom_fields
lors de la création du Customer dans Braintree via votre système backend.
Lors de la création d’un client dans Braintree, nous vous recommandons toujours d’envoyer le pays et l’adresse IP. Cela facilitera la conformité avec la TVA de l’UE.
Pour les ventes B2B, vous devez également envoyer le tax_id
du client dans le champ custom_fields
.
Chez Quaderno, nous utilisons Ruby on Rails, voici comment nous procéderions en Ruby :
customer = Braintree::Customer.create( first_name: 'Maurice', last_name: 'Moss', company: 'Reynholm Industries', email: '[email protected]', payment_method_nonce: 'nonce-from-the-client', credit_card: { billing_address: { street_address: '123 Carenden Road', locality: 'London', postal_code: 'EC5M 8AJ', country_code_alpha2: 'GB' } }, custom_fields: { tax_id: 'GB184089977', ip_address: request.ip } )
Personnaliser les informations de transaction
Pour les transactions ponctuelles, vous pouvez également spécifier la description de la transaction avec custom_fields
lors de la création de la transaction dans Braintree. Par exemple :
transaction = Braintree::Transaction.sale( amount: '10.00', payment_method_nonce: nonce_from_the_client, custom_fields: { transaction_description: 'The Neverending Story, Michael Ende (EPUB)' } )
Avant d’utiliser un champ personnalisé, les noms des champs custom_fields
doivent être configurés dans votre Braintree Control Panel, et les valeurs doivent contenir moins de 255 caractères.
Lors de la création d’un champ personnalisé, sélectionnez l’option Store
et Pass Back
. Quaderno a besoin que ces champs soient stockés dans votre compte Braintree.
Champs personnalisés
Tous les champs custom_fields
sont facultatifs. Quaderno peut gérer les champs suivants :
Champ custom_fields |
Description |
---|---|
tax_id |
Numéro d’identification fiscale (clients uniquement) |
ip_address |
Adresse IP du client (clients uniquement) |
transaction_description |
Description de la transaction (transactions ponctuelles uniquement) |
additional_evidence_country |
Code pays de la preuve (format ISO 3166-1 alpha-2 : ES, FR, US, GB, etc.) |
additional_evidence_type |
Brève description (255 caractères max) de la preuve. Champ requis. |
sku |
Code unique du produit ou service vendu |