user.go

// Copyright 2014 Mathias Monnerville. All rights reserved.
// Use of this source code is governed by a GPL
// license that can be found in the LICENSE file.

package mango

const (
	KYCLevelLight   = "LIGHT"
	KYCLevelRegular = "REGULAR"
)

const (
	PersonTypeNatural = "NATURAL"
	PersonTypeLegal   = "LEGAL"
)

// A Consumer is a legal or natural user with zero, one or
// more wallets and tranfers.
type Consumer interface {
	// All user's wallets
	Wallets() (WalletList, error)
	// All user's transactions
	Transfers() (TransferList, error)
}

type UserList []*User

// User is used by the user activity API and describe common fields to
// both natural and legal users.
type User struct {
	ProcessIdent
	PersonType string
	Email      string
}

func (u *User) String() string {
	return struct2string(u)
}

// Users returns a list of all registered users, either natural
// or legal.
func (m *MangoPay) Users() (UserList, error) {
	resp, err := m.request(actionAllUsers, nil)
	if err != nil {
		return nil, err
	}
	ul := UserList{}
	if err := m.unMarshalJSONResponse(resp, &ul); err != nil {
		return nil, err
	}
	return ul, nil
}

// User fetch a user (natural or legal) using the Id attribute.
func (m *MangoPay) User(id string) (*User, error) {
	u, err := m.anyRequest(new(User), actionFetchUser, JsonObject{"Id": id})
	if err != nil {
		return nil, err
	}
	return u.(*User), nil
}