Customer

Customer: Update

RubySDK

• Current Braintree SDKs
• Java
• .NET
• Node.js
• PHP
• Python
• Ruby

See also the Customer response object.

To update a customer, use its ID along with new attributes. The same validations apply as when creating a customer. Any attribute not passed will remain unchanged.

result = gateway.customer.update(
  "a_customer_id", # id of customer to update
  :first_name => "New First Name",
  :last_name => "New Last Name"
)
if result.success?
  puts "customer successfully updated"
else
  p result.errors
end

Arguments

Additional Parameters

Examples

Update customer and existing credit card

To update an existing credit card when using the customer update method, you need to pass the token of the credit card under the credit card options.

note

Credit cards are the only payment method type that you can update using the customer update method. To update other payment method types, use Payment Method: Update.

result = gateway.customer.update(
  "a_customer_id", # id of customer to update
  :payment_method_nonce => nonce_from_the_client,
  :email => "new.email@example.com",
  :credit_card => {
    :options => {
      # token of credit card to update
      :update_existing_token => "the_token"
    }
  }
)

If you are only storing the customer ID in your system and using a 1:1 model of customer to credit card, then you can get the token for the credit card from the customer details.

customer = gateway.customer.find("a_customer_id")
token = customer.credit_cards[0].token

Update customer, credit card, and billing address

The billing address can also be updated by adding in the billing address details and setting the update_existing option in the billing address attributes.

note

Using this method, you can update any of the credit card parameters listed above, but some parameters have been deprecated to avoid any PCI concerns with raw credit card data being present on your server.

result = gateway.customer.update(
  "a_customer_id",
  :payment_method_nonce => nonce_from_the_client,
  :email => "new.email@example.com",
  :credit_card => {
    :options => {
      :update_existing_token => "the_token",
    },
    :billing_address => {
      :street_address => "New Street Address",
      :postal_code => "60622",
      :options => {
        :update_existing => true
      }
    }
  }
)

If you omit the update_existing valoption under the billing address, we will create a new address for the customer and associate it to the credit card. The old address will remain associated to the customer but no longer associated as the billing address of the credit card.

Update customer and create new payment method

You can add a new payment method to an existing customer using the customer update API.

Credit card

If you omit the update_existing_token valoption from the examples in the previous sections, a new credit card will be created and associated to the customer.

customer = gateway.customer.find("the_customer_id")
customer.credit_cards.size
#=> 1
result = gateway.customer.update(
  customer.id,
  :payment_method_nonce => nonce_from_the_client
)
if result.success?
  result.customer.credit_cards.size
  #=> 2
end

Any payment method type

You can use a payment method nonce for any payment method type—not just a credit card—to associate that payment method to the customer. The example below shows adding a payment method while also updating customer details.

result = gateway.customer.update(
  "a_customer_id", # id of customer to update
  :payment_method_nonce => nonce_from_the_client,
  :email => "new.email@example.com",
)

Update default payment method

To update a customer's default payment method, get that payment method's token and pass it as the default_payment_method_token value below:

result = gateway.customer.update(
  "a_customer_id",
  :default_payment_method_token => "the_token"
)

Card verification

By default we will run credit card validations but not perform verification. Braintree strongly recommends verifying all cards before they are stored in your Vault by enabling card verification for your entire account in the Control Panel. If you choose to manually verify cards, set verify_card to true.

result = gateway.customer.update(
  "a_customer_id",
  :payment_method_nonce => nonce_from_the_client,
  :credit_card => {
    :options => {
      :update_existing_token => "the_token",
      :verify_card => true
    }
  }
)

important

If you are using our Premium Fraud Management Tools, we strongly recommend passing device_data each time you verify a card.

See also

• Customer validations
• Payment method validations
• Card verification