Sending transaction details from Braintree

Quaderno automatically generates invoices and credit notes using the customer details received from Braintree, which in turn receives the information from the platform you use to manage your sales. This article covers how to customize that data — it's aimed at integrators and developers.

Customizing the customer billing info

You can customize the billing info in your invoices using the billing_address and custom_fields hashes when you create the Braintree Customer in your backend.

Always send the country and ip_address fields — this makes it easier to comply with EU VAT requirements. For B2B sales, also send your customer's tax_id in custom_fields.

Here's a Ruby example:

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
  }
)

Customizing the transaction info

For one-off transactions, you can specify a description using custom_fields when creating the 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)'
  }
)

Custom fields reference

All custom_fields fields are optional. Quaderno supports the following: