class ApiCards extends ApiBase (View source)

Class to management MangoPay API for cards

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
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
Get(string $cardId)

Get card

Card[]
GetByFingerprint(string $fingerprint, Pagination $pagination = null, Sorting $sorting = null)

Gets a list of cards having the same fingerprint.

Update(Card $card)

Update card

GetPreAuthorizations(int $cardId, Pagination $pagination = null, $filter = null, Sorting $sorting = null)

Gets a Card's PreAuthorizations

GetTransactions(string $cardId, Pagination $pagination = null, FilterTransactions $filter = null, Sorting $sorting = null)

Retrieves a list of Transactions pertaining to a certain Card

ValidateCard($cardId, $cardValidation)

Validate a card

GetCardValidation($cardId, $cardValidationId)

Get card validation

Details

protected mixed getLogger()

No description

Return Value

mixed

__construct($root)

Constructor

Parameters

$root

protected string GetRequestUrl(string $key)

Get URL for REST Mango Pay API

Parameters

string $key

Key with data

Return Value

string

protected RequestType GetRequestType(string $key)

Get request type for REST Mango Pay API

Parameters

string $key

Key with data

Return Value

RequestType

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

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

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

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

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

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

protected array BuildRequestData(object $entity)

Get array with request data

Parameters

object $entity

Entity object to send as request data

Return Value

array

protected GetObjectForIdempotencyUrl($url)

No description

Parameters

$url

Card Get(string $cardId)

Get card

Parameters

string $cardId

Card identifier

Return Value

Card

object returned from API

Card[] GetByFingerprint(string $fingerprint, Pagination $pagination = null, Sorting $sorting = null)

Gets a list of cards having the same fingerprint.

The fingerprint is a hash uniquely generated per 16-digit card number.

Parameters

string $fingerprint

The fingerprint hash

Pagination $pagination

Pagination object

Sorting $sorting

Sorting object

Return Value

Card[]

List of Cards corresponding to provided fingerprint

Card Update(Card $card)

Update card

Parameters

Card $card

Card object to save

Return Value

Card

Card object returned from API

CardPreAuthorization[] GetPreAuthorizations(int $cardId, Pagination $pagination = null, $filter = null, Sorting $sorting = null)

Gets a Card's PreAuthorizations

Parameters

int $cardId

ID of the Card for which to retrieve PreAuthorizations

Pagination $pagination

Pagination object

$filter
Sorting $sorting

Sorting object

Return Value

CardPreAuthorization[]

List of the Card's PreAuthorizations

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

Retrieves a list of Transactions pertaining to a certain Card

Parameters

string $cardId

Card identifier

Pagination $pagination

Pagination object

FilterTransactions $filter

Filtering object

Sorting $sorting

Sorting object

Return Value

Transaction[]

CardValidation ValidateCard($cardId, $cardValidation)

Validate a card

Parameters

$cardId
$cardValidation

Return Value

CardValidation

Exceptions

Exception

Card GetCardValidation($cardId, $cardValidationId)

Get card validation

Parameters

$cardId
$cardValidationId

Return Value

Card

Exceptions

Exception