Envoyer les détails des transactions depuis Braintree

Quaderno génère automatiquement vos factures et notes de crédit à partir des informations client reçues de Braintree, qui récupère à son tour les données de la plateforme que vous utilisez pour gérer vos ventes. Cet article explique comment personnaliser ces données — il s'adresse aux intégrateurs et aux développeurs.

Personnaliser les informations de facturation du client

Vous pouvez personnaliser les informations de facturation sur vos factures en utilisant les objets billing_address et custom_fields lors de la création du Customer dans Braintree via votre backend.

Envoyez toujours les champs country et ip_address — cela facilite la conformité avec la TVA de l'UE. Pour les ventes B2B, envoyez également le tax_id du client dans custom_fields.

Voici un exemple 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 spécifier la description de la transaction avec custom_fields lors de la création de la transaction :

transaction = Braintree::Transaction.sale(
  amount: '10.00',
  payment_method_nonce: nonce_from_the_client,
  custom_fields: {
    transaction_description: 'The Neverending Story, Michael Ende (EPUB)'
  }
)

Référence des champs personnalisés

Tous les champs custom_fields sont facultatifs. Quaderno prend en charge les champs suivants :