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

ApiCards

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(MangoPayApi $root)

Constructor Root/parent instance that holds the OAuthToken and Configuration instance

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
GetApiVersion($key)

No description

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
CreateOrUpdateMultipartObject(string $methodKey, string $file, string $fileName, string $responseClassName = null, string $entityId = null, string $idempotencyKey = null)

No description

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

Get entity object from API

from  ApiBase
object
GetObjectManyQueryParams(string $methodKey, object $responseClassName, ...$queryParams)

Get entity object from API endpoint that has a lot of query params

from  ApiBase
object
GetObjectWithPagination(string $methodKey, object $responseClassName, $pagination = null, $filter = null, $entityId = null, $clientIdRequired = true)

Get entity object from API on a request path that contains pagination and other query params

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
UpdateObject($methodKey, $entity, $responseClassName = null, $firstEntityId = null, $secondEntityId = null, $thirdEntityId = null)

Does the same thing as SaveObject above, but keeps natural order of provided entity ids when building the URL

from  ApiBase
DeleteObject($methodKey, $entity, $responseClassName = null)

No description

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

Executes a POST request

from  ApiBase
Error
CastResponseToError(object $response)

Cast response object to an error object

from  ApiBase
CastResponseToEntity($response, $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
Card
Get(string $cardId)

Get card

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

Gets a list of cards having the same fingerprint.

Card
Update(Card $card)

Update card

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

Gets a 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

CardValidation
ValidateCard(mixed $cardId, $cardValidation)

Validate a card

Card
GetCardValidation(mixed $cardId, $cardValidationId)

Get card validation

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

Gets a list of transactions having for a card fingerprint.

Details

in ApiBase at line 19
protected mixed getLogger()

No description

Return Value

mixed

in ApiBase at line 319
__construct(MangoPayApi $root)

Constructor Root/parent instance that holds the OAuthToken and Configuration instance

Parameters

MangoPayApi $root

in ApiBase at line 329
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 339
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 344
protected GetApiVersion($key)

No description

Parameters

$key

in ApiBase at line 360
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 399
protected object CreateOrUpdateMultipartObject(string $methodKey, string $file, string $fileName, string $responseClassName = null, string $entityId = null, string $idempotencyKey = null)

No description

Parameters

string $methodKey

Key with request data
string $file

The file content (raw binary string)
string $fileName

The file name
string $responseClassName

Name of entity class from response
string $entityId

Optional entity identifier
string $idempotencyKey

Optional idempotency key

Return Value

object

Response data

Exceptions

Exception

in ApiBase at line 428
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 457
protected object GetObjectManyQueryParams(string $methodKey, object $responseClassName, ...$queryParams)

Get entity object from API endpoint that has a lot of query params

Parameters

string $methodKey

Key with request data
object $responseClassName

Name of entity class from response
...$queryParams

Return Value

object

Response data

Exceptions

Exception

in ApiBase at line 477
protected object GetObjectWithPagination(string $methodKey, object $responseClassName, $pagination = null, $filter = null, $entityId = null, $clientIdRequired = true)

Get entity object from API on a request path that contains pagination and other query params

Parameters

string $methodKey

Key with request data
object $responseClassName

Name of entity class from response
$pagination
$filter
$entityId
$clientIdRequired

Return Value

object

Response data

Exceptions

Exception

in ApiBase at line 520
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 558
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 589
protected UpdateObject($methodKey, $entity, $responseClassName = null, $firstEntityId = null, $secondEntityId = null, $thirdEntityId = null)

Does the same thing as SaveObject above, but keeps natural order of provided entity ids when building the URL

Parameters

$methodKey
$entity
$responseClassName
$firstEntityId
$secondEntityId
$thirdEntityId

in ApiBase at line 613
protected DeleteObject($methodKey, $entity, $responseClassName = null)

No description

Parameters

$methodKey
$entity
$responseClassName

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

Executes a POST request

Parameters

mixed $methodKey

Key with request data
mixed $entity

Entity object
mixed $responseClassName

Name of entity class from response
mixed $entityId

Entity identifier
$idempotency_key

Return Value

object

Response data

in ApiBase at line 664
protected Error CastResponseToError(object $response)

Cast response object to an error object

Parameters

object $response

Object from API response

Return Value

Error

The error

in ApiBase at line 700
protected CastResponseToEntity($response, $entityClassName, $asDependentObject = false)

Cast response object to entity object

Parameters

$response
$entityClassName
$asDependentObject

in ApiBase at line 815
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 876
protected GetObjectForIdempotencyUrl($url)

No description

Parameters

$url

at line 15
Card Get(string $cardId)

Get card

Parameters

string $cardId

Card identifier

Return Value

Card

object returned from API

at line 29
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

at line 39
Card Update(Card $card)

Update card

Parameters

Card $card

Card object to save

Return Value

Card

Card object returned from API

at line 52
CardPreAuthorization[] GetPreAuthorizations(int $cardId, Pagination $pagination = null, FilterPreAuthorizations $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
FilterPreAuthorizations $filter

Filtering object
Sorting $sorting

Sorting object

Return Value

CardPreAuthorization[]

List of the Card's PreAuthorizations

at line 65
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[]

at line 76
CardValidation ValidateCard(mixed $cardId, $cardValidation)

Validate a card

Parameters

mixed $cardId
$cardValidation

Return Value

CardValidation

Exceptions

Exception

at line 87
Card GetCardValidation(mixed $cardId, $cardValidationId)

Get card validation

Parameters

mixed $cardId

, $cardValidationId
$cardValidationId

Return Value

Card

Exceptions

Exception

at line 102
Transaction[] GetTransactionsByFingerprint(string $fingerprint, FilterTransactions $filter = null, Pagination $pagination = null, Sorting $sorting = null)

Gets a list of transactions having for a card fingerprint.

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

Parameters

string $fingerprint

The fingerprint hash
FilterTransactions $filter

Filter object
Pagination $pagination

Pagination object
Sorting $sorting

Sorting object

Return Value

Transaction[]

List of Transactions corresponding to provided fingerprint