Release v3.0.0

mercadopago · Feb 3, 2025 · 64a8129 · 64a8129
1 parent 78fe7a0
commit 64a8129
Show file tree

Hide file tree

Showing 59 changed files with 244 additions and 81 deletions.
diff --git a/.env.sample b/.env.sample
@@ -4,4 +4,5 @@ PUBLIC_KEY=<Put your public_key test>
 PUBLIC_KEY_3DS=<Put your public_key test>
 NOTIFICATION_URL=<Put your notification_url>
 APPLICATION_ID=<Put your application_id>
-PRODUCT_ID=<Put a valid product_id>
+PRODUCT_ID=<Put a valid product_id>
+URIS_SCOPE=<Put beta if you want to test on beta URI scopes>
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -5,6 +5,10 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## V3.0.0
+### Added
+- Add new parameter `uris_scope` on SDK instantiation to allow use of beta scopes on APIs calls
+
 ## V2.13.0
 ### Added
 - Add new method to get onboarding data for the new credential autofill flow

diff --git a/README.md b/README.md
@@ -24,17 +24,19 @@ Para incluir a biblioteca em seu projeto, basta fazer o seguinte:
 <?php
     require('vendor/autoload.php');
 
-    $sdk = new Sdk('accessToken', 'platformId', 'productId', 'integratorId', 'publicKey');
+    $sdk = new Sdk('accessToken', 'platformId', 'productId', 'integratorId', 'publicKey', 'urisScope');
 
 ```
 
+Os parâmetros para instanciar a SDK são: Access Token, Platform ID, Product ID, Integrator ID, Public Key e URIs Scope que deve ser preenchido com `beta` caso queira que as URIs das APIs acessadas estejam em Beta.
+
 ## Criando um pagamento
 
 ```php
 <?php
     require('vendor/autoload.php');
 
-    $sdk = new Sdk('accessToken', 'platformId', 'productId', 'integratorId', 'publicKey');
+    $sdk = new Sdk('accessToken', 'platformId', 'productId', 'integratorId', 'publicKey', 'urisScope');
 
     $payment = $sdk->getPaymentInstance();
 
@@ -57,7 +59,7 @@ Para incluir a biblioteca em seu projeto, basta fazer o seguinte:
 <?php
     require('vendor/autoload.php');
 
-    $sdk = new Sdk('accessToken', 'platformId', 'productId', 'integratorId', 'publicKey');
+    $sdk = new Sdk('accessToken', 'platformId', 'productId', 'integratorId', 'publicKey', 'urisScope');
 
     $payment = $sdk->getPaymentInstance();
 
@@ -70,7 +72,7 @@ Para incluir a biblioteca em seu projeto, basta fazer o seguinte:
 <?php
     require('vendor/autoload.php');
 
-    $sdk = new Sdk('accessToken', 'platformId', 'productId', 'integratorId', 'publicKey');
+    $sdk = new Sdk('accessToken', 'platformId', 'productId', 'integratorId', 'publicKey', 'urisScope');
 
     $preference = $sdk->getPreferenceInstance();
 
@@ -104,7 +106,7 @@ O parâmetro para consulta deve seguir o modelo abaixo:
 <?php
     require('vendor/autoload.php');
 
-    $sdk = new Sdk('accessToken', 'platformId', 'productId', 'integratorId', 'publicKey');
+    $sdk = new Sdk('accessToken', 'platformId', 'productId', 'integratorId', 'publicKey', 'urisScope');
 
     $notification = $sdk->getNotificationInstance();
 
@@ -118,7 +120,7 @@ O parâmetro para consulta deve seguir o modelo abaixo:
 <?php
     require('vendor/autoload.php');
 
-    $sdk = new Sdk('accessToken', 'platformId', 'productId', 'integratorId', 'publicKey');
+    $sdk = new Sdk('accessToken', 'platformId', 'productId', 'integratorId', 'publicKey', 'urisScope');
 
     $datadogEvent = $sdk->getDatadogEventInstance();
 
@@ -145,7 +147,7 @@ O parâmetro para consulta deve seguir o modelo abaixo:
 <?php
     require('vendor/autoload.php');
 
-    $sdk = new Sdk('accessToken', 'platformId', 'productId', 'integratorId', 'publicKey');
+    $sdk = new Sdk('accessToken', 'platformId', 'productId', 'integratorId', 'publicKey', 'urisScope');
 
     $registerErrorLog = $sdk->getRegisterErrorLogInstance();
 
@@ -175,7 +177,7 @@ O parâmetro para consulta deve seguir o modelo abaixo:
 <?php
     require('vendor/autoload.php');
 
-    $sdk = new Sdk('accessToken', 'platformId', 'productId', 'integratorId', 'publicKey');
+    $sdk = new Sdk('accessToken', 'platformId', 'productId', 'integratorId', 'publicKey', 'urisScope');
 
     $paymentMethods = $sdk->getPaymentMethodsInstance();
 
@@ -191,7 +193,7 @@ Exemplo de requisição agrupando os meios de pagamento pelo campo id:
 <?php
     require('vendor/autoload.php');
 
-    $sdk = new Sdk('accessToken', 'platformId', 'productId', 'integratorId', 'publicKey');
+    $sdk = new Sdk('accessToken', 'platformId', 'productId', 'integratorId', 'publicKey', 'urisScope');
 
     $paymentMethods = $sdk->getPaymentMethodsInstance();
 
@@ -213,7 +215,7 @@ Exemplo de requisição agrupando os meios de pagamento pelo campo id:
         echo "</pre>";
     }
 
-    $sdk = new Sdk( 'accessToken', 'platformId', 'productId', 'integratorId', 'publicKey' );
+    $sdk = new Sdk( 'accessToken', 'platformId', 'productId', 'integratorId', 'publicKey', 'urisScope' );
 
     $merchantOrder = $sdk->getMerchantOrderInstance();
 
@@ -236,7 +238,7 @@ Exemplo de requisição agrupando os meios de pagamento pelo campo id:
         echo "</pre>";
     }
 
-    $sdk = new Sdk( 'accessToken', 'platformId', 'productId', 'integratorId', 'publicKey' );
+    $sdk = new Sdk( 'accessToken', 'platformId', 'productId', 'integratorId', 'publicKey', 'urisScope' );
 
     $createSellerFunnelBase = $sdk->getCreateSellerFunnelBaseInstance();
 
@@ -268,7 +270,7 @@ Exemplo de requisição agrupando os meios de pagamento pelo campo id:
         echo "</pre>";
     }
 
-    $sdk = new Sdk( 'accessToken', 'platformId', 'productId', 'integratorId', 'publicKey' );
+    $sdk = new Sdk( 'accessToken', 'platformId', 'productId', 'integratorId', 'publicKey', 'urisScope' );
 
     $updateSellerFunnelBase = $sdk->getUpdateSellerFunnelBaseInstance();
 
@@ -293,7 +295,7 @@ Exemplo de requisição agrupando os meios de pagamento pelo campo id:
 <?php
     require('vendor/autoload.php');
 
-    $sdk = new Sdk('accessToken', 'platformId', 'productId', 'integratorId', 'publicKey');
+    $sdk = new Sdk('accessToken', 'platformId', 'productId', 'integratorId', 'publicKey', 'urisScope');
 
     $exchange = $sdk->getExchangeInstance();
 
@@ -309,7 +311,8 @@ Exemplo de requisição agrupando os meios de pagamento pelo campo id:
         'platformId',
         'productId',
         'integratorId',
-        'publicKey'
+        'publicKey',
+        'urisScope'
     );
 
     $onboarding = $sdk->getOnboardingInstance();

diff --git a/composer.json b/composer.json
@@ -1,7 +1,7 @@
 {
   "name": "mp-plugins/php-sdk",
   "description": "Mercado Pago Plugins PHP-SDK",
-  "version": "2.13.0",
+  "version": "3.0.0",
   "type": "library",
   "scripts": {
     "lint": "./vendor/bin/phpcs -q --report=checkstyle --standard=PSR2 src",

diff --git a/composer.lock b/composer.lock
diff --git a/examples/Exchange.php b/examples/Exchange.php
@@ -11,7 +11,7 @@ function debug($value)
         echo "</pre>";
     }
 
-    $sdk = new Sdk('accessToken', 'platformId', 'productId', 'integratorId', 'publicKey');
+    $sdk = new Sdk('accessToken', 'platformId', 'productId', 'integratorId', 'publicKey', 'urisScope');
 
     $exchange = $sdk->getExchangeInstance();
 

diff --git a/examples/Multipayment.php b/examples/Multipayment.php
@@ -10,7 +10,7 @@ function debug($value){
         echo "</pre>";
     }
 
-    $sdk = new Sdk( 'accessToken', 'platformId', 'productId', 'integratorId', 'publicKey' );
+    $sdk = new Sdk( 'accessToken', 'platformId', 'productId', 'integratorId', 'publicKey', 'urisScope' );
 
     //Payment with two Cards
     $multipayment = $sdk->getMultipaymentInstance();

diff --git a/examples/createSellerFunnelBase.php b/examples/createSellerFunnelBase.php
@@ -10,7 +10,7 @@ function debug($value){
         echo "</pre>";
     }
 
-    $sdk = new Sdk( 'accessToken', 'platformId', 'productId', 'integratorId', 'publicKey' );
+    $sdk = new Sdk( 'accessToken', 'platformId', 'productId', 'integratorId', 'publicKey', 'urisScope' );
 
     $createSellerFunnelBase = $sdk->getCreateSellerFunnelBaseInstance();
 

diff --git a/examples/datadog_event.php b/examples/datadog_event.php
@@ -10,7 +10,7 @@ function debug($value){
         echo "</pre>";
     }
 
-    $sdk = new Sdk( 'accessToken', 'platformId', 'productId', 'integratorId', 'publicKey' );
+    $sdk = new Sdk( 'accessToken', 'platformId', 'productId', 'integratorId', 'publicKey', 'urisScope' );
 
     $datadogEvent = $sdk->getDatadogEventInstance();
 

diff --git a/examples/getOnboardingData.php b/examples/getOnboardingData.php
@@ -15,7 +15,8 @@ function debug($value){
         'platformId',
         'productId',
         'integratorId',
-        'publicKey'
+        'publicKey',
+        'urisScope'
     );
 
     $onboarding = $sdk->getOnboardingInstance();

diff --git a/examples/groupedPaymentMethods.php b/examples/groupedPaymentMethods.php
@@ -10,7 +10,7 @@ function debug($value){
         echo "</pre>";
     }
 
-    $sdk = new Sdk( 'accessToken', 'platformId', 'productId', 'integratorId', 'publicKey' );
+    $sdk = new Sdk( 'accessToken', 'platformId', 'productId', 'integratorId', 'publicKey', 'urisScope' );
 
     $paymentMethods = $sdk->getPaymentMethodsInstance();
 

diff --git a/examples/merchantOrder.php b/examples/merchantOrder.php
@@ -9,7 +9,7 @@ function debug($value){
         echo "</pre>";
     }
 
-    $sdk = new Sdk( 'accessToken', 'platformId', 'productId', 'integratorId', 'publicKey' );
+    $sdk = new Sdk( 'accessToken', 'platformId', 'productId', 'integratorId', 'publicKey', 'urisScope' );
 
     $merchantOrder = $sdk->getMerchantOrderInstance();
 

diff --git a/examples/monitoring_register_log.php b/examples/monitoring_register_log.php
@@ -11,7 +11,7 @@ function debug($value)
         echo "</pre>";
     }
 
-    $sdk = new Sdk( 'accessToken', 'platformId', 'productId', 'integratorId', 'publicKey' );
+    $sdk = new Sdk( 'accessToken', 'platformId', 'productId', 'integratorId', 'publicKey', 'urisScope' );
 
     $registerErrorLog = $sdk->getRegisterErrorLogInstance();
 

diff --git a/examples/notification.php b/examples/notification.php
@@ -10,7 +10,7 @@ function debug($value){
         echo "</pre>";
     }
 
-    $sdk = new Sdk( 'accessToken', 'platformId', 'productId', 'integratorId', 'publicKey' );
+    $sdk = new Sdk( 'accessToken', 'platformId', 'productId', 'integratorId', 'publicKey', 'urisScope' );
 
     $notification = $sdk->getNotificationInstance();
 

diff --git a/examples/payment.php b/examples/payment.php
@@ -10,7 +10,7 @@ function debug($value){
         echo "</pre>";
     }
 
-    $sdk = new Sdk( 'accessToken', 'platformId', 'productId', 'integratorId', 'publicKey' );
+    $sdk = new Sdk( 'accessToken', 'platformId', 'productId', 'integratorId', 'publicKey', 'urisScope' );
 
     $payment = $sdk->getPaymentInstance();
 

diff --git a/examples/paymentMethods.php b/examples/paymentMethods.php
@@ -10,7 +10,7 @@ function debug($value){
         echo "</pre>";
     }
 
-    $sdk = new Sdk( 'accessToken', 'platformId', 'productId', 'integratorId', 'publicKey' );
+    $sdk = new Sdk( 'accessToken', 'platformId', 'productId', 'integratorId', 'publicKey', 'urisScope' );
 
     $paymentMethods = $sdk->getPaymentMethodsInstance();
 

diff --git a/examples/payment_3ds.php b/examples/payment_3ds.php
@@ -11,7 +11,7 @@ function debug($value){
         echo "</pre>";
     }
 
-    $sdk = new Sdk( 'accessToken', 'platformId', 'productId', 'integratorId', 'publicKey' );
+    $sdk = new Sdk( 'accessToken', 'platformId', 'productId', 'integratorId', 'publicKey', 'urisScope' );
 
     $payment = $sdk->getPaymentInstance();
 

diff --git a/examples/preference.php b/examples/preference.php
@@ -10,7 +10,7 @@ function debug($value){
         echo "</pre>";
     }
 
-    $sdk = new Sdk( 'accessToken', 'platformId', 'productId', 'integratorId', 'publicKey' );
+    $sdk = new Sdk( 'accessToken', 'platformId', 'productId', 'integratorId', 'publicKey', 'urisScope' );
 
     $preference = $sdk->getPreferenceInstance();
 

diff --git a/examples/updateSellerFunnelBase.php b/examples/updateSellerFunnelBase.php
@@ -10,7 +10,7 @@ function debug($value){
         echo "</pre>";
     }
 
-    $sdk = new Sdk( 'accessToken', 'platformId', 'productId', 'integratorId', 'publicKey' );
+    $sdk = new Sdk( 'accessToken', 'platformId', 'productId', 'integratorId', 'publicKey', 'urisScope' );
 
     $updateSellerFunnelBase = $sdk->getUpdateSellerFunnelBaseInstance();
 

diff --git a/src/Common/Config.php b/src/Common/Config.php
@@ -29,11 +29,16 @@ class Config
      */
     private $integrator_id;
 
-        /**
+    /**
      * @var string
      */
     private $public_key;
 
+    /**
+     * @var string
+     */
+    private $uris_scope;
+
     /**
      * Config constructor.
      *
@@ -42,19 +47,22 @@ class Config
      * @param string|null $product_id
      * @param string|null $integrator_id
      * @param string|null $public_key
+     * @param string|null $uris_scope
      */
     public function __construct(
         string $access_token = null,
         string $platform_id = null,
         string $product_id = null,
         string $integrator_id = null,
-        string $public_key = null
+        string $public_key = null,
+        string $uris_scope = null
     ) {
         $this->access_token = $access_token;
         $this->platform_id = $platform_id;
         $this->product_id = $product_id;
         $this->integrator_id = $integrator_id;
         $this->public_key = $public_key;
+        $this->uris_scope = $uris_scope;
     }
 
     /**

diff --git a/src/Common/Manager.php b/src/Common/Manager.php
@@ -67,7 +67,8 @@ public function execute(AbstractEntity $entity, string $uri, string $method = 'g
     public function getEntityUri(AbstractEntity $entity, string $method, array $params = [], array $queryStrings = [])
     {
         if (method_exists($entity, 'getUris')) {
-            $uri = $entity->getUris()[$method];
+            $uris_scope = $this->config->__get('uris_scope');
+            $uri = $entity->getUris($uris_scope)[$method];
             $matches = [];
             preg_match_all('/\\:\\w+/', $uri, $matches);
 

diff --git a/src/Entity/Exchange/Exchange.php b/src/Entity/Exchange/Exchange.php
@@ -78,10 +78,12 @@ public function getHeaders(): array
      *
      * @return array
      */
-    public function getUris(): array
+    public function getUris(string $uris_scope = null): array
     {
+        $scope_ppcore = $uris_scope === 'beta' ? 'beta' : 'prod';
+
         return array(
-            'get' => '/ppcore/prod/payment-methods/v1/exchange',
+            'get' => '/ppcore/' . $scope_ppcore . '/payment-methods/v1/exchange',
         );
     }
 

diff --git a/src/Entity/Identification/CreateSellerFunnelBase.php b/src/Entity/Identification/CreateSellerFunnelBase.php
@@ -58,10 +58,12 @@ public function __construct($manager)
      *
      * @return array
      */
-    public function getUris(): array
+    public function getUris(string $uris_scope = null): array
     {
+        $scope_ppcore = $uris_scope === 'beta' ? 'beta' : 'v1';
+
         return array(
-            'post' => '/v1/eplatforms/core/identification/seller-configuration/start-integration',
+            'post' => '/' . $scope_ppcore . '/eplatforms/core/identification/seller-configuration/start-integration',
         );
     }