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
Ceci a-t-il répondu à votre question? Merci pour vos feedback Il y a eu un problème pour soumettre vos commentaires. Veuillez réessayer plus tard.

Besoin d'aide? Contactez-nous Contactez-nous