1. class
  2. MangoPay
  3. \
  4. ApiUsers

ApiUsers

class ApiUsers extends ApiBase (View source)

Class to manage MangoPay API calls for the user entity.

Properties

protected MangoPayApi $_root

Root/parent instance that holds the OAuthToken and Configuration instance

 from  ApiBase

Methods

mixed
getLogger()

No description

from  ApiBase
__construct($root)

Constructor

from  ApiBase
string
GetRequestUrl(string $key)

Get URL for REST Mango Pay API

from  ApiBase
RequestType
GetRequestType(string $key)

Get request type for REST Mango Pay API

from  ApiBase
object
CreateObject(string $methodKey, object $entity, object $responseClassName = null, string $entityId = null, $subEntityId = null, $idempotencyKey = null)

Create object in API

from  ApiBase
object
GetObject(string $methodKey, object $responseClassName, $firstEntityId = null, $secondEntityId = null, $thirdEntityId = null, $clientIdRequired = true)

Get entity object from API

from  ApiBase
object[]
GetList(string $methodKey, Pagination $pagination, object $responseClassName = null, string $entityId = null, object $filter = null, Sorting $sorting = null, $secondEntityId = null, $clientIdRequired = true)

Get lst with entities object from API

from  ApiBase
object
SaveObject(string $methodKey, object $entity, object $responseClassName = null, $secondEntityId = null, $thirdEntityId = null)

Save object in API

from  ApiBase
object
ExecutePostRequest($methodKey, $entity, $responseClassName, $entityId = null)

Executes a POST request

from  ApiBase
CastResponseToEntity(object $response, string $entityClassName, $asDependentObject = false)

Cast response object to entity object

from  ApiBase
array
BuildRequestData(object $entity)

Get array with request data

from  ApiBase
GetObjectForIdempotencyUrl($url)

No description

from  ApiBase
UserLegal|UserNatural
Create(UserLegal|UserNatural $user, $idempotencyKey = null)

Create a new user

UserLegal[]|UserNatural[]
GetAll(Pagination $pagination = null, Sorting $sorting = null)

Get all users

UserLegal|UserNatural
Get(string $userId)

Get natural or legal user by ID

UserNatural
GetNatural(string $userId)

Get natural user by ID

UserLegal
GetLegal(string $userId)

Get legal user by ID

UserLegal|UserNatural
Update(UserLegal|UserNatural $user)

Save user

BankAccount
CreateBankAccount(string $userId, BankAccount $bankAccount, $idempotencyKey = null)

Create bank account for user

BankAccount[]
GetBankAccounts(string $userId, Pagination $pagination = null, Sorting $sorting = null, FilterBankAccounts $filter = null)

Get all bank accounts for user

BankAccount
GetBankAccount(string $userId, int $bankAccountId)

Get bank account for user

BankAccount
UpdateBankAccount(string $userId, BankAccount $bankAccount)

Save a bank account

Wallet[]
GetWallets(string $userId, Pagination $pagination = null, Sorting $sorting = null)

Get all wallets for user

Transaction[]
GetTransactions(string $userId, Pagination $pagination = null, FilterTransactions $filter = null, Sorting $sorting = null)

Get all transactions for user

Card[]
GetCards(string $userId, Pagination $pagination = null, FilterCards $filter = null, Sorting $sorting = null)

Get all cards for user

KycDocument
CreateKycDocument(string $userId, KycDocument $kycDocument, string $idempotencyKey = null)

Create new KYC document

KycDocument[]
GetKycDocuments(string $userId, Pagination $pagination = null, Sorting $sorting = null, FilterKycDocuments $filter = null)

Get all KYC documents for user

KycDocument
GetKycDocument(string $userId, string $kycDocumentId)

Get KYC document

Mandate[]
GetMandates(string $userId, Pagination $pagination = null, FilterTransactions $filter = null, Sorting $sorting = null)

Get all mandates for user

Mandate[]
GetMandatesForBankAccount(string $userId, string $bankAccountId, Pagination $pagination = null, FilterTransactions $filter = null, Sorting $sorting = null)

Get mandates for user and bank account

KycDocument
UpdateKycDocument(string $userId, KycDocument $kycDocument)

Save KYC document

true
CreateKycPage(string $userId, string $kycDocumentId, KycPage $kycPage, $idempotencyKey = null)

Create page for Kyc document

true
CreateKycPageFromFile(string $userId, string $kycDocumentId, string $filePath, $idempotencyKey = null)

Create page for Kyc document from file

EMoney
GetEMoney(string $userId, $year = null, $month = null)

Get user EMoney

CardPreAuthorization[]
GetPreAuthorizations(string $userId, Pagination $pagination = null, FilterPreAuthorizations $filter = null, Sorting $sorting = null)

Gets a list with PreAuthorizations belonging to a specific user

UserBlockStatus
GetBlockStatus(string $userId)

Get the Block Status of a User

UserBlockStatus
GetRegulatory(string $userId)

Get the Block Status Regulatory of a User

CompanyNumberDetails
ValidateTheFormatOfUserData($companyNumberDetails)

This call allows you to check the validity of the format of a piece of user data, and to retrieve the validation rules applied to it.

Details

in ApiBase at line 19
protected mixed getLogger()

No description

Return Value

mixed

in ApiBase at line 242
__construct($root)

Constructor

Parameters

$root

in ApiBase at line 252
protected string GetRequestUrl(string $key)

Get URL for REST Mango Pay API

Parameters

string $key

Key with data

Return Value

string

in ApiBase at line 262
protected RequestType GetRequestType(string $key)

Get request type for REST Mango Pay API

Parameters

string $key

Key with data

Return Value

RequestType

in ApiBase at line 275
protected object CreateObject(string $methodKey, object $entity, object $responseClassName = null, string $entityId = null, $subEntityId = null, $idempotencyKey = null)

Create object in API

Parameters

string $methodKey

Key with request data
object $entity

Entity object
object $responseClassName

Name of entity class from response
string $entityId

Entity identifier
$subEntityId
$idempotencyKey

Return Value

object

Response data

in ApiBase at line 311
protected object GetObject(string $methodKey, object $responseClassName, $firstEntityId = null, $secondEntityId = null, $thirdEntityId = null, $clientIdRequired = true)

Get entity object from API

Parameters

string $methodKey

Key with request data
object $responseClassName

Name of entity class from response
$firstEntityId
$secondEntityId
$thirdEntityId
$clientIdRequired

Return Value

object

Response data

Exceptions

Exception

in ApiBase at line 341
protected object[] GetList(string $methodKey, Pagination $pagination, object $responseClassName = null, string $entityId = null, object $filter = null, Sorting $sorting = null, $secondEntityId = null, $clientIdRequired = true)

Get lst with entities object from API

Parameters

string $methodKey

Key with request data
Pagination $pagination

Pagination object
object $responseClassName

Name of entity class from response
string $entityId

Entity identifier
object $filter

Object to filter data
Sorting $sorting

Object to sorting data
$secondEntityId
$clientIdRequired

Return Value

object[]

Response data

in ApiBase at line 378
protected object SaveObject(string $methodKey, object $entity, object $responseClassName = null, $secondEntityId = null, $thirdEntityId = null)

Save object in API

Parameters

string $methodKey

Key with request data
object $entity

Entity object to save
object $responseClassName

Name of entity class from response
$secondEntityId
$thirdEntityId

Return Value

object

Response data

in ApiBase at line 413
protected object ExecutePostRequest($methodKey, $entity, $responseClassName, $entityId = null)

Executes a POST request

Parameters

$methodKey

Key with request data
$entity

Entity object
$responseClassName

Name of entity class from response
$entityId

Entity identifier

Return Value

object

Response data

in ApiBase at line 439
protected CastResponseToEntity(object $response, string $entityClassName, $asDependentObject = false)

Cast response object to entity object

Parameters

object $response

Object from API response
string $entityClassName

Name of entity class to cast
$asDependentObject

in ApiBase at line 526
protected array BuildRequestData(object $entity)

Get array with request data

Parameters

object $entity

Entity object to send as request data

Return Value

array

in ApiBase at line 583
protected GetObjectForIdempotencyUrl($url)

No description

Parameters

$url

at line 16
UserLegal|UserNatural Create(UserLegal|UserNatural $user, $idempotencyKey = null)

Create a new user

Parameters

UserLegal|UserNatural $user
$idempotencyKey

Return Value

UserLegal|UserNatural

User object returned from API

Exceptions

Exception

at line 37
UserLegal[]|UserNatural[] GetAll(Pagination $pagination = null, Sorting $sorting = null)

Get all users

Parameters

Pagination $pagination

Pagination object
Sorting $sorting

Object to sorting data

Return Value

UserLegal[]|UserNatural[]

Array with users

at line 55
UserLegal|UserNatural Get(string $userId)

Get natural or legal user by ID

Parameters

string $userId

User identifier

Return Value

UserLegal|UserNatural

User object returned from API

at line 66
UserNatural GetNatural(string $userId)

Get natural user by ID

Parameters

string $userId

User identifier

Return Value

UserNatural

User object returned from API

at line 77
UserLegal GetLegal(string $userId)

Get legal user by ID

Parameters

string $userId

User identifier

Return Value

UserLegal

User object returned from API

at line 89
UserLegal|UserNatural Update(UserLegal|UserNatural $user)

Save user

Parameters

UserLegal|UserNatural $user

Return Value

UserLegal|UserNatural

User object returned from API

Exceptions

Exception

at line 125
BankAccount CreateBankAccount(string $userId, BankAccount $bankAccount, $idempotencyKey = null)

Create bank account for user

Parameters

string $userId

User Id
BankAccount $bankAccount

Entity of bank account object
$idempotencyKey

Return Value

BankAccount

Create bank account object

at line 140
BankAccount[] GetBankAccounts(string $userId, Pagination $pagination = null, Sorting $sorting = null, FilterBankAccounts $filter = null)

Get all bank accounts for user

Parameters

string $userId

User Id
Pagination $pagination

Pagination object
Sorting $sorting

Object to sorting data
FilterBankAccounts $filter

Filtering object

Return Value

BankAccount[]

Array with bank account entities

at line 152
BankAccount GetBankAccount(string $userId, int $bankAccountId)

Get bank account for user

Parameters

string $userId

User Id
int $bankAccountId

Bank account Id

Return Value

BankAccount

Entity of bank account object

at line 163
BankAccount UpdateBankAccount(string $userId, BankAccount $bankAccount)

Save a bank account

Parameters

string $userId
BankAccount $bankAccount

Return Value

BankAccount

Entity of bank account object

at line 176
Wallet[] GetWallets(string $userId, Pagination $pagination = null, Sorting $sorting = null)

Get all wallets for user

Parameters

string $userId

User Id
Pagination $pagination

Pagination object
Sorting $sorting

Object to sorting data

Return Value

Wallet[]

Array with objects returned from API

at line 190
Transaction[] GetTransactions(string $userId, Pagination $pagination = null, FilterTransactions $filter = null, Sorting $sorting = null)

Get all transactions for user

Parameters

string $userId

User Id
Pagination $pagination

Pagination object
FilterTransactions $filter

Object to filter data
Sorting $sorting

Object to sorting data

Return Value

Transaction[]

Transactions for user returned from API

at line 204
Card[] GetCards(string $userId, Pagination $pagination = null, FilterCards $filter = null, Sorting $sorting = null)

Get all cards for user

Parameters

string $userId

User Id
Pagination $pagination

Pagination object
FilterCards $filter

Object to filter data
Sorting $sorting

Object to sorting data

Return Value

Card[]

Cards for user returned from API

at line 216
KycDocument CreateKycDocument(string $userId, KycDocument $kycDocument, string $idempotencyKey = null)

Create new KYC document

Parameters

string $userId

User Id
KycDocument $kycDocument
string $idempotencyKey

Key for response replication

Return Value

KycDocument

Document returned from API

at line 230
KycDocument[] GetKycDocuments(string $userId, Pagination $pagination = null, Sorting $sorting = null, FilterKycDocuments $filter = null)

Get all KYC documents for user

Parameters

string $userId

User Id
Pagination $pagination

Pagination object
Sorting $sorting

Object to sorting data
FilterKycDocuments $filter

Object to filter data

Return Value

KycDocument[]

Array with KYC documents entities

at line 241
KycDocument GetKycDocument(string $userId, string $kycDocumentId)

Get KYC document

Parameters

string $userId

User Id
string $kycDocumentId

Document identifier

Return Value

KycDocument

Document returned from API

at line 255
Mandate[] GetMandates(string $userId, Pagination $pagination = null, FilterTransactions $filter = null, Sorting $sorting = null)

Get all mandates for user

Parameters

string $userId

User Id
Pagination $pagination

Pagination object
FilterTransactions $filter

Object to filter data
Sorting $sorting

Object to sorting data

Return Value

Mandate[]

Array with mandate entities

at line 270
Mandate[] GetMandatesForBankAccount(string $userId, string $bankAccountId, Pagination $pagination = null, FilterTransactions $filter = null, Sorting $sorting = null)

Get mandates for user and bank account

Parameters

string $userId

User Id
string $bankAccountId

Bank account Id
Pagination $pagination

Pagination object
FilterTransactions $filter

Object to filter data
Sorting $sorting

Object to sorting data

Return Value

Mandate[]

Array with mandate entities

at line 281
KycDocument UpdateKycDocument(string $userId, KycDocument $kycDocument)

Save KYC document

Parameters

string $userId

User Id
KycDocument $kycDocument

Document to save

Return Value

KycDocument

Document returned from API

at line 294
true CreateKycPage(string $userId, string $kycDocumentId, KycPage $kycPage, $idempotencyKey = null)

Create page for Kyc document

Parameters

string $userId

User Id
string $kycDocumentId

KYC Document Id
KycPage $kycPage

KYC Page
$idempotencyKey

Return Value

true

always true. If an error occurred, a \MangoPay\Libraries\Exception is thrown

Exceptions

Exception

at line 315
true CreateKycPageFromFile(string $userId, string $kycDocumentId, string $filePath, $idempotencyKey = null)

Create page for Kyc document from file

Parameters

string $userId

User Id
string $kycDocumentId

KYC Document Id
string $filePath

File path
$idempotencyKey

Return Value

true

always true. If an error occurred, a \MangoPay\Libraries\Exception is thrown

Exceptions

Exception

at line 343
EMoney GetEMoney(string $userId, $year = null, $month = null)

Get user EMoney

Parameters

string $userId

User Id
$year
$month

Return Value

EMoney

EMoney obhect returned from API

Exceptions

Exception

at line 371
CardPreAuthorization[] GetPreAuthorizations(string $userId, Pagination $pagination = null, FilterPreAuthorizations $filter = null, Sorting $sorting = null)

Gets a list with PreAuthorizations belonging to a specific user

Parameters

string $userId

ID of the user whose PreAuthorizations to retrieve
Pagination $pagination

Pagination object
FilterPreAuthorizations $filter

Filtering object
Sorting $sorting

Sorting object

Return Value

CardPreAuthorization[]

The user's PreAuthorizations

at line 413
UserBlockStatus GetBlockStatus(string $userId)

Get the Block Status of a User

Parameters

string $userId

User identifier

Return Value

UserBlockStatus

User object returned from API

at line 423
UserBlockStatus GetRegulatory(string $userId)

Get the Block Status Regulatory of a User

Parameters

string $userId

User identifier

Return Value

UserBlockStatus

User object returned from API

at line 434
CompanyNumberDetails ValidateTheFormatOfUserData($companyNumberDetails)

This call allows you to check the validity of the format of a piece of user data, and to retrieve the validation rules applied to it.

Parameters

$companyNumberDetails

Return Value

CompanyNumberDetails