added a clear method to accounts

accounts.go

@@ -37,6 +37,9 @@ type AccountsService interface {
 	// https://dev.recurly.com/docs/update-account
 	Update(ctx context.Context, accountCode string, a Account) (*Account, error)
 
+	// Clear empties added info on a account.
+	Clear(ctx context.Context, accountCode string) error
+
 	// Close marks an account as closed and cancels any active subscriptions.
 	// Paused subscriptions will be expired.
 	//
@@ -97,6 +100,16 @@ type Account struct {
 	TransactionType         string             `xml:"transaction_type,omitempty"` // Create only
 }
 
+// clearAccount is a helper object for clearing info from a recurly account.
+type clearAccount struct {
+	XMLName   xml.Name `xml:"account"`
+	Code      string   `xml:"account_code,omitempty"`
+	FirstName string   `xml:"first_name"`
+	LastName  string   `xml:"last_name"`
+	VATNumber string   `xml:"vat_number"`
+	Address   *Address `xml:"address"`
+}
+
 // AccountBalance is used for getting the account balance.
 type AccountBalance struct {
 	XMLName xml.Name   `xml:"account_balance"`
@@ -194,6 +207,17 @@ func (s *accountsImpl) Update(ctx context.Context, code string, a Account) (*Acc
 	return &dst, err
 }
 
+func (s *accountsImpl) Clear(ctx context.Context, code string) error {
+	path := fmt.Sprintf("/accounts/%s", code)
+	a := clearAccount{}
+	req, err := s.client.newRequest("PUT", path, a)
+	if err != nil {
+		return err
+	}
+	_, err = s.client.do(ctx, req, nil)
+	return err
+}
+
 func (s *accountsImpl) Close(ctx context.Context, code string) error {
 	path := fmt.Sprintf("/accounts/%s", code)
 	req, err := s.client.newRequest("DELETE", path, nil)

accounts_test.go

@@ -377,6 +377,22 @@ func TestAccounts_Update(t *testing.T) {
 	}
 }
 
+func TestAccounts_Clear(t *testing.T) {
+	client, s := recurly.NewTestServer()
+	defer s.Close()
+
+	s.HandleFunc("PUT", "/v2/accounts/1", func(w http.ResponseWriter, r *http.Request) {
+		w.WriteHeader(http.StatusOK)
+		w.Write(MustOpenFile("account.xml"))
+	}, t)
+
+	if err := client.Accounts.Clear(context.Background(), "1"); !s.Invoked {
+		t.Fatal("expected fn invocation")
+	} else if err != nil {
+		t.Fatal(err)
+	}
+}
+
 func TestAccounts_Close(t *testing.T) {
 	client, s := recurly.NewTestServer()
 	defer s.Close()