Conversions Quote

MangoPay/ApiInstantConversion.php → MangoPay/ApiConversions.php

@@ -5,7 +5,7 @@
 /**
  * Class to management MangoPay API for instant conversions
  */
-class ApiInstantConversion extends Libraries\ApiBase
+class ApiConversions extends Libraries\ApiBase
 {
     /**
      * This endpoint allows the platform to get a real
@@ -40,4 +40,25 @@ public function GetInstantConversion($id)
     {
         return $this->GetObject('get_instant_conversion', '\MangoPay\InstantConversion', $id);
     }
+
+    /**
+     * This call guarantees a conversion rate to let you Create a Quoted Conversion.
+     * @param ConversionQuote $quote
+     * @return ConversionQuote
+     */
+    public function CreateConversionQuote($quote)
+    {
+        return $this->CreateObject('create_conversion_quote', $quote, '\MangoPay\ConversionQuote');
+    }
+
+    /**
+     * This endpoint allows the platform to get the details of a quote
+     * @param string $quoteId
+     * @return ConversionQuote
+     */
+    public function GetConversionQuote($quoteId)
+    {
+        return $this->GetObject('get_conversion_quote', '\MangoPay\ConversionQuote', $quoteId);
+    }
+
 }

MangoPay/ConversionQuote.php

@@ -0,0 +1,43 @@
+<?php
+
+namespace MangoPay;
+
+use MangoPay\Libraries\EntityBase;
+
+class ConversionQuote extends EntityBase
+{
+    /**
+     * Expiration date
+     * @var int
+     */
+    public $ExpirationDate;
+
+    /**
+     * @var string
+     * @see \MangoPay\TransactionStatus
+     */
+    public $Status;
+
+    /**
+     * The time in seconds during which the quote is active and can be used for conversions.
+     * @var int
+     */
+    public $Duration;
+
+    /**
+     * Debited funds
+     * @var \MangoPay\Money
+     */
+    public $DebitedFunds;
+
+    /**
+     * Credited funds
+     * @var \MangoPay\Money
+     */
+    public $CreditedFunds;
+
+    /**
+     * @var ConversionRate
+     */
+    var $ConversionRateResponse;
+}

MangoPay/Libraries/ApiBase.php

@@ -227,7 +227,9 @@ protected function getLogger()
 
         'get_conversion_rate' => ['/conversions/rate/%s/%s', RequestType::GET],
         'create_instant_conversion' => ['/conversions/instant-conversion', RequestType::POST],
-        'get_instant_conversion' => ['/conversions/%s', RequestType::GET]
+        'get_instant_conversion' => ['/conversions/%s', RequestType::GET],
+        'create_conversion_quote' => ['/conversions/quote', RequestType::POST],
+        'get_conversion_quote' => ['/conversions/quote/%s', RequestType::GET],
     ];
 
     /**

MangoPay/MangoPayApi.php

@@ -199,9 +199,9 @@ class MangoPayApi
 
     /**
      * Provides Instant conversion API methods
-     * @var ApiInstantConversion
+     * @var ApiConversions
      */
-    public $InstantConversion;
+    public $Conversions;
 
     /**
      * Constructor
@@ -239,7 +239,7 @@ public function __construct()
         $this->Repudiations = new ApiRepudiations($this);
         $this->Regulatory = new ApiRegulatory($this);
         $this->Deposits = new ApiDeposits($this);
-        $this->InstantConversion = new ApiInstantConversion($this);
+        $this->Conversions = new ApiConversions($this);
 
         // Setting default NullLogger
         $this->logger = new NullLogger();

tests/Cases/InstantConversionTest.php → tests/Cases/ConversionsTest.php

@@ -2,15 +2,16 @@
 
 namespace MangoPay\Tests\Cases;
 
+use MangoPay\ConversionQuote;
 use MangoPay\InstantConversion;
 use MangoPay\Money;
 use MangoPay\TransactionType;
 
-class InstantConversionTest extends Base
+class ConversionsTest extends Base
 {
     public function test_getConversionRate()
     {
-        $response = $this->_api->InstantConversion->GetConversionRate('EUR', 'GBP');
+        $response = $this->_api->Conversions->GetConversionRate('EUR', 'GBP');
 
         $this->assertNotNull($response);
         $this->assertNotNull($response->ClientRate);
@@ -31,7 +32,7 @@ public function test_createInstantConversion()
     public function test_getInstantConversion()
     {
         $instantConversion = $this->createInstantConversion();
-        $returnedInstantConversion = $this->_api->InstantConversion->GetInstantConversion($instantConversion->Id);
+        $returnedInstantConversion = $this->_api->Conversions->GetInstantConversion($instantConversion->Id);
 
         $this->assertNotNull($returnedInstantConversion);
         $this->assertNotNull($returnedInstantConversion->DebitedFunds->Amount);
@@ -40,6 +41,27 @@ public function test_getInstantConversion()
         $this->assertSame(TransactionType::Conversion, $returnedInstantConversion->Type);
     }
 
+    public function test_createConversionQuote(){
+        $response = $this->createConversionQuote();
+
+        $this->assertNotNull($response);
+        $this->assertNotNull($response->DebitedFunds->Amount);
+        $this->assertNotNull($response->CreditedFunds->Amount);
+        $this->assertNotNull($response->ConversionRateResponse->ClientRate);
+        $this->assertSame('ACTIVE', $response->Status);
+    }
+
+    public function test_getConversionQuote(){
+        $quote = $this->createConversionQuote();
+        $response = $this->_api->Conversions->GetConversionQuote($quote->Id);
+
+        $this->assertNotNull($response);
+        $this->assertNotNull($response->DebitedFunds->Amount);
+        $this->assertNotNull($response->CreditedFunds->Amount);
+        $this->assertNotNull($response->ConversionRateResponse->ClientRate);
+        $this->assertSame('ACTIVE', $response->Status);
+    }
+
     private function createInstantConversion()
     {
         $john = $this->getJohn();
@@ -73,6 +95,26 @@ private function createInstantConversion()
 
         $instantConversion->Tag = "create instant conversion";
 
-        return $this->_api->InstantConversion->CreateInstantConversion($instantConversion);
+        return $this->_api->Conversions->CreateInstantConversion($instantConversion);
+    }
+
+    private function createConversionQuote()
+    {
+
+        $quote = new ConversionQuote();
+        $creditedFunds = new Money();
+        $creditedFunds->Currency = 'USD';
+        $quote->CreditedFunds = $creditedFunds;
+
+        $debitedFunds = new Money();
+        $debitedFunds->Currency = 'GBP';
+        $debitedFunds->Amount = 1000;
+        $quote->DebitedFunds = $debitedFunds;
+
+        $quote->Duration = 90;
+        $quote->Tag = "Created using the Mangopay PHP SDK";
+
+        return $this->_api->Conversions->CreateConversionQuote($quote);
+
     }
 }