class ApiConversions extends ApiBase (View source)

Class to management MangoPay API for instant conversions

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
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
CastResponseToError(object $response)

Cast response object to an error object

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
GetConversionRate(string $debitedCurrency, string $creditedCurrency)

This endpoint allows the platform to get a real time indicative market rate of a specific currency pair.

CreateInstantConversion(CreateInstantConversion $instantConversion)

This endpoint allows the platform to move funds between two wallets of different currencies instantaneously.

CreateClientWalletsInstantConversion(CreateClientWalletsInstantConversion $instantConversion)

This call triggers an immediate conversion at the market rate, of the debited funds to the credited wallet at the market rate.

CreateQuotedConversion(CreateQuotedConversion $quotedConversion)

This call triggers a conversion, at the rate guaranteed by its quote, of the debited funds to the credited wallet.

CreateClientWalletsQuotedConversion(CreateClientWalletsQuotedConversion $quotedConversion)

This call triggers a conversion at the rate defined in its quote.

GetConversion(string $id)

This endpoint allows the platform to get the details of a conversion which has been carried out.

CreateConversionQuote(ConversionQuote $quote)

This call guarantees a conversion rate to let you Create a Quoted Conversion.

GetConversionQuote(string $quoteId)

This endpoint allows the platform to get the details of a quote

Details

protected mixed getLogger()

No description

Return Value

mixed

__construct(MangoPayApi $root)

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

Parameters

MangoPayApi $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 Error CastResponseToError(object $response)

Cast response object to an error object

Parameters

object $response

Object from API response

Return Value

Error

The error

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

ConversionRate GetConversionRate(string $debitedCurrency, string $creditedCurrency)

This endpoint allows the platform to get a real time indicative market rate of a specific currency pair.

The rate returned is given in real time.

Parameters

string $debitedCurrency

The sell currency – the currency of the wallet to be debited

string $creditedCurrency

The buy currency – the currency of the wallet to be credited.

Return Value

ConversionRate

object returned from API

Conversion CreateInstantConversion(CreateInstantConversion $instantConversion)

This endpoint allows the platform to move funds between two wallets of different currencies instantaneously.

Parameters

CreateInstantConversion $instantConversion

Return Value

Conversion

object returned from API

Conversion CreateClientWalletsInstantConversion(CreateClientWalletsInstantConversion $instantConversion)

This call triggers an immediate conversion at the market rate, of the debited funds to the credited wallet at the market rate.

A quote is not required for an instant conversion.

Parameters

CreateClientWalletsInstantConversion $instantConversion

Return Value

Conversion

object returned from API

Conversion CreateQuotedConversion(CreateQuotedConversion $quotedConversion)

This call triggers a conversion, at the rate guaranteed by its quote, of the debited funds to the credited wallet.

Parameters

CreateQuotedConversion $quotedConversion

Return Value

Conversion

Conversion CreateClientWalletsQuotedConversion(CreateClientWalletsQuotedConversion $quotedConversion)

This call triggers a conversion at the rate defined in its quote.

The debited funds (buy currency), credited funds (sell currency) and currencies are defined in the quote. The Client Wallets to debit and credit are defined in the conversion.

Each quoted conversion requires a dedicated Quote object, linked in the QuoteId.*

Parameters

CreateClientWalletsQuotedConversion $quotedConversion

Return Value

Conversion

Conversion GetConversion(string $id)

This endpoint allows the platform to get the details of a conversion which has been carried out.

Parameters

string $id

The unique identifier of the conversion.

Return Value

Conversion

object returned from API

ConversionQuote CreateConversionQuote(ConversionQuote $quote)

This call guarantees a conversion rate to let you Create a Quoted Conversion.

Parameters

ConversionQuote $quote

Return Value

ConversionQuote

ConversionQuote GetConversionQuote(string $quoteId)

This endpoint allows the platform to get the details of a quote

Parameters

string $quoteId

Return Value

ConversionQuote