Skip to content

Instantly share code, notes, and snippets.

@plencovich
Last active January 7, 2024 14:34
  • Star 10 You must be signed in to star a gist
  • Fork 0 You must be signed in to fork a gist
Star You must be signed in to star a gist
Save plencovich/acde7aac03c23146c2d5a0cff5656bc3 to your computer and use it in GitHub Desktop.
Breve explicación para poder crear una app en Mercadopago para tener un marketplace

Plenco

Mercadopago Marketplace

Mini tutorial para crear una app de marketplace en mercadopago usando PHP y DX-PHP

Es una ayuda memora en referencia a la excelente información que está en Mercadopago Developers

Creación de APP y Conexión de Usuarios.

  1. Crear una aplicación para marketplace donde:

    • en Redirect URI deben poner la url con https://dominio.com/auth/mercadopago ese formato uso en mi caso; esta url es la que los usuarios van a ser redireccionados luego de confirmar la autorización.
    • tildar los scopes read, write, offline access
    • topicos recomendados: items, orders, create orders, payments
    • url de callback, es la url en donde van a recibir las notificaciones de MP, yo uso https://dominio.com/webhook/mercadopago
  2. Crear un boton en el backend o panel de administración de tu vendedor, para que pueda vincular su cuenta de mercadopago al marketplace. Ese boton debe tener el siguiente formato: https://auth.mercadopago.com.ar/authorization?client_id={APP_ID}&response_type=code&platform_id=mp&state={USER_ID_REF}&redirect_uri=https%3A%2F%2Fdominio.com/auth/mercadopago, donde {APP_ID} es el número que corresponde a tu app de marketplace; {USER_ID_REF} es un código identificador para luego saber que usuario estás conectando y redirect_uri es la misma url que setearon al crear la app.

  3. En el código, en la entrada en donde es redireccionado el vendedor, siguiendo el ejemplo dominio.com/auth/mercadopago tenes que tener un código similar a esto:

    public function auth_provider()
    {
        $code = $this->input->get('code');
        $state = $this->input->get('state');

        // Compruebo que la url tenga el ?code= y el state de mercadopago
        if (isset($code) AND isset($docId)) {

            // Configuro para hacer el POST y obtener el token y datos del usuario

            $url = 'https://api.mercadopago.com/oauth/token';
            $post = '&client_secret='.$this->accessToken.'&grant_type=authorization_code&code='.$code.'&redirect_uri=https://dominio.com/auth/mercadopago';

            $mpResp = $this->utility->curlAPIRestPOST($url,$post,$this->accessToken);

            if ($mpResp->status == 200) {

                // Actualizo en mi DB los datos obtenidos
                $info = array(
                    'mp_access_token' => $mpResp->access_token,
                    'mp_public_key' => $mpResp->public_key,
                    'mp_refresh_token' => $mpResp->refresh_token,
                    'mp_user_id' => $mpResp->user_id,
                    'mp_expires_in' => $mpResp->expires_in,
                    'mp_created_at' => date('Y-m-d H:i:s', time()),
                    'mp_scope' => $mpResp->scope,
                    'mp_live_mode' => $mpResp->live_mode,
                    'mp_token_type' => $mpResp->token_type,
                    'mp_status' => 1
                );

                $update = $this->professionals->update_info($info, $docId);

                // Esto no es necesario pero lo hago para obtener el nick en ML del usuario para que pueda identificar la cuenta
                $url_get = 'https://api.mercadolibre.com/users/me';

                $mpResp = $this->utility->curlAPIRestGET($url_get,$this->accessToken);

                $info = array(
                    'doc_mp_nick_name' => $mpResp->nickname,
                    'doc_email_mercadopago' => $mpResp->email
                );

                $update = $this->professionals->update_info($info, $pdocIdid);
            }
        }
        // Redireccionar a otra web o mostrarle una vista.
        ........
    }

Funciones de cURL GET y POST que utilizo en una librería

public function curlAPIRestPOST($url,$post,$accessToken)
    {
        $curl = curl_init();
        curl_setopt_array($curl,[
            CURLOPT_URL => $url,
            CURLOPT_POST => 1,
            CURLOPT_POSTFIELDS => $post,
            CURLOPT_RETURNTRANSFER => true,
            CURLOPT_TIMEOUT => 5,
            CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
            CURLOPT_HTTPHEADER => array(
                "Authorization: Bearer ".$accessToken,
              ),
        ]);

        $response = curl_exec($curl);
        $httpcode = curl_getinfo($curl, CURLINFO_HTTP_CODE);
        curl_close($curl);
        $contents = json_decode($response);

        if ($httpcode == 200) {
            $contents->status = 200;
            return $contents;
        } else {
            $contents->status = 400;
            return $contents;
        }
    }

    public function curlAPIRestGET($url, $accessToken)
    {
        $curl = curl_init();
        curl_setopt_array($curl,[
            CURLOPT_URL => $url,
            CURLOPT_RETURNTRANSFER => true,
            CURLOPT_TIMEOUT => 5,
            CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
            CURLOPT_HTTPHEADER => array(
                "Authorization: Bearer ".$accessToken,
              ),
        ]);

        $response = curl_exec($curl);
        $httpcode = curl_getinfo($curl, CURLINFO_HTTP_CODE);
        curl_close($curl);
        $contents = json_decode($response);

        if ($httpcode == 200) {
            $contents->status = 200;
            return $contents;
        } else {
            $contents->status = 400;
            return $contents;
        }
    }

Creación de preferencia de pago para checkout

// Set del Access Token del vendedor
MercadoPago\SDK::setAccessToken(ACCESS_TOKEN_DEL_VENDEDOR);

// Si son Mercadopago Dev Certificados, tienen ese código, sino omitir esa linea
MercadoPago\SDK::setIntegratorId(getenv('MP_DEV_CODE'));

$preference = new MercadoPago\Preference();

$item = new MercadoPago\Item();
$item->id = 22233;
$item->title = 'Nombre del Producto o texto para que el comprador identifique que está pagando';
$item->currency_id = 'ARS';
$item->description = 'Breve descripción';
$item->picture_url = 'URL de la imagen del producto';
$item->quantity = 1;
$item->unit_price = (float)$price;

$preference->items = array($item);

$payer = new MercadoPago\Payer();
$payer->name = 'Nombre del Comprador';
$payer->surname = 'Apellido del Comprador';
$payer->email = 'Dirección de Email;
$payer->date_created = 'Fecha de registro del usuario en nuestro sistema, en formato: date('Y-m-d\TH:i:s.vP')';
$payer->identification = array(
    "type" => "DNI",
    "number" => 'Número de DNI'
);
$payer->identification_type = 'DNI';
$payer->identification_number = 'Número de DNI';
$payer->phone = array(
    "area_code" => "54",
    "number" => 'Número de Teléfono'
);
$payer->area_code = '54';
$payer->number = 'Número de Teléfono';

$payer->address = array(
    "street_name" => 'Domicilio',
    "zip_code" => 'Código Postal'
    );

$payer->authentication_type = 'Web Nativa'; // Pueden ser Gmail, Facebook, Web Nativa, Otro.
$payer->registration_date = 'Fecha de registro del usuario en nuestro sistema, en formato: date('Y-m-d\TH:i:s.vP')';
$payer->is_first_purchase_online = 'TRUE o FALSE si es la primera vez que compra.;
$payer->last_purchase = "Si is_first_purchase_online = TRUE deberán ingresar la fecha de la última vez que compró en formato: date('Y-m-d\TH:i:s.vP')";

$preference->payer = $payer;

// Opcional por si quieren quitar métodos de pago de la preferencia y setear las cuotas
$preference->payment_methods = array(
    "excluded_payment_types" => array(
        array("id" => "atm"),
        array('id' => 'bank_transfer'),
        array('id' => 'ticket')
    ),
    "installments" => 12,
    "default_installments" => 1
);

// Opcional para setear las url de pago aprobado, fallido o pendiente
$preference->back_urls = array(
    "success" => 'https://dominio.com/mp/ok',
    "failure" => 'https://dominio.com/mp/error',
    "pending" => 'https://dominio.com/mp/pending'
);

// Retorna siempre
$preference->auto_return = "all";

// Para que no tenga estados pendientes de pago
$preference->binary_mode = TRUE;

// Creación de un código external reference para vincular el pago con un pedido en nuestra DB
$preference->external_reference = $codecart;

// Si van a cobrar una comision por venta
$preference->marketplace_fee = (float)$mp_fee_owner;

// Opcional para setear las url del webhook
$preference->notification_url = 'https://dominio.com/webhook/mercadopago';

// Crea la preferencia
$preference->save();

// Redirecciona al webcheckout de mercadopago, pueden usar este método u otros como poner el link en un boton y mostrar en una vista con el detalle de la compra y el boton pagar.

redirect($preference->{gcfg('mp_mode',NULL)},'refresh');

Información adicional en las preferencias de pago para la prevención de fraude y contracargos:

Configuración del Webhooks

  1. Acceder en la siguiente URL https://www.mercadopago.com/mla/account/webhooks y configurar en modo producción la url donde van a recibir las notificaciones de mercadopago, y tildar los eventos que desean captar, mis recomendados son: pagos, aplicaciones conectadas/desconectadas y split de pagos. Siguiente el ejemplo, usar https://dominio.com/webhook/mercadopago y al presionar probar, le debe dar un response ok 200

  2. Luego crear un código en la ruta del dominio seteado: https://dominio.com/webhook/mercadopago mi código es algo así:

public function webhook()
{
    MercadoPago\SDK::setAccessToken(ACCESS_TOKEN_MARKETPLACE);
    MercadoPago\SDK::setIntegratorId(getenv('MP_DEV_CODE'));
    $info = json_decode($this->input->raw_input_stream);

    if (isset($info->type)) {
        switch ($info->type) {
            case 'mp-connect':
                // Desvinculo de mi sistema cuando el usuario desautoriza la app desde su cuenta de Mercadopago.
                if ($info->action == 'application.deauthorized') {

                    $data_update = array(
                        'mp_access_token' => NULL,
                        'mp_public_key' => NULL,
                        'mp_refresh_token' => NULL,
                        'mp_user_id' => NULL,
                        'mp_expires_in' => NULL,
                        'mp_status' => 0
                    );

                    $this->producers->update_mp_connect($data_update, $info->user_id);
                    $this->output->set_status_header(200);
                    return;
                }

                // Pueden tomar otra acción si el $info->action = 'application.authrized'
            break;

            case 'payment':
                // Actualizo la información de pago recibida.
                $or_collection_id = $info->data->id;
                $info = MercadoPago\Payment::find_by_id($or_collection_id);
                $or_number = $info->external_reference;

                $data_update = array(
                    'or_collection_status' => $info->status,
                    'or_collection_status_detail' => $info->status_detail,
                    'or_payment_type' => $info->payment_type_id,
                    'or_payment_method' => $info->payment_method_id,
                    'or_status' => gcfg($info->status,'or_status_collection_status')
                );

                $this->cart->update_ipn_order($data_update,$or_number);

            break;

            default:
                $this->output->set_status_header(200);
                return;
            break;
        }
    }
    $this->output->set_status_header(200);
    return;
}
@Wagimo
Copy link

Wagimo commented Jan 26, 2022

Hola Amigo. Muchas gracias por compartir tu experiencia en este tema. Te quiero pedir un favor y es orientarme sobre la integracion MarketPlace? Te comento, ya genero las credenciales de autorización para cobrar a nombre de un usuario vendedor, esos datos, como el access_token, el refresh_token y el public_key los persisto en mi BD.
Tambien puedo generar la preferencia haciendo uso del access_token del usuario vendedor y asi mismo, puedo renderizar el boton de pago en la vista utilizando el sdk V2 de Mercado pago. Este boton recibe dos parametros, el preference_id que identifica la preferencia creada y el Public_Key obtenido desde la Aplicacion MarketPlace. El problema radica que cuando doy click en el boton de pago, se lanza el Popup con un error que dice:
Algo salió mal...
Una de las partes con la que intentas hacer el pago es de prueba.
La verdad no sé que esta pasando, ya que tambien cuando genero la preferencia, envío en el Json en la propiedad email del pagador, el correo electronico de uno de los usuarios de Test que he generado con anterioridad en Mercado Pago.
tu me puedes regalar una luz de que esta mal? o como debo proceder para terminar con el flujo de integración?
muchas Gracias!!

@plencovich
Copy link
Author

@Wagimo seguramente el problema es que tenes iniciada una session en mercadopago con la cuenta del usuario vendedor o del marketplace; ese error es muy común porque no puedes pagarte a vos mismo.
Asegurate de tener las sessiones cerradas o bien, en muchos casos se prueba directo en modo incognito.
También puede crear otro usuario de prueba para que actue como cliente.

@Wagimo
Copy link

Wagimo commented Jan 31, 2022 via email

@plencovich
Copy link
Author

@Wagimo entonces tendrías que asegurarte que las 3 partes sean usuarios de prueba. cuenta marketplace. cuenta vendedor, cuenta cliente.
Y sino podes hacer en tu cuenta de mercadopago, crear un marketplace; con otra cuenta real de mercadopago conectarte a ese marketplace como vendedor; y con otra cuenta de mercadopago ser el cliente; y en la configuración de tu proyecto usas siempre las credenciales de sandbox, con el sandbox_init_point.

@joaquincanete
Copy link

Hola estimado desde ya gracias por compartir tu experiencia es de mucha ayuda para muchos !!!, te cuento que no estoy pudiendo agregar la preferencia de payer para especificar si compra por primera ves. uso el plugin de mercado pago para woocommerce en wordpress y estoy rindiendo la certificación de integración y no logro colocar la preferencia en el archivo que corresponde.

la preferencia de warranty = true ya la coloque en class-wc-woomercadopago-preference-abstract.php y funciono no estoy dando donde sumar la preferencia de si es primer compra. muchas gracias

@faaguilars
Copy link

Hola colegas, de antemano te agradezco mucho la información, realmente es de mucha ayuda en ese tema del marketplace con mercado pago que para mi experiencia no es muy claro de como utilizar, ahora tengo una duda sobre su integración, quizá me puedas dar una luz frente a como usar esta integración cuando un solo comprador va a realizar la compra mediante un carrito de compras a dos o más diferentes vendedores?, es decir el le va a comprar n artículos al vendedor x y n artículos al vendedor y, ¿Qué debo hacer para cobrar en nombre de los dos al mismo tiempo?, ¿deben hacerse dos transacciones por separadas?, estoy demasiado confundido con esto y realmente es lo único que me tiene estancado en este desarrollo, te agradezco mucho tu ayuda.

@apastrana-auntap
Copy link

Buenas colegas, gracias por compartir esta información. Quería hacer una consulta, me encuentro trabajando con la API de checkout de MP y puedo configurar todas las opciones sin problema, salvo marketplace_fee. En la documentación oficial https://www.mercadopago.com.co/developers/es/reference/preferences/_checkout_preferences/post dice que solo se puede enviar si esta configurado un marketplace valido (otra propiedades dentro de la preferencia).

Mi consulta seria si alguno sabe a que hace referencia el campo marketplace y donde se obtiene el string (campo alfanumérico) para indicarlo?

Desde ya muchas gracias por la ayuda.

@tomasmalio
Copy link

Hola, ¿cómo estás? Disculpa que te moleste pero me llama la atención la poca documentación de MercadoPago y estaba viendo el código de lo que implementaste.

HIce un desarrollo similar en Node JS pero me está fallando el Checkout. Tengo generado el access_token del vendedor pero cuando armo todo para hacer el POST, me tira un error de que es invalido:

{ "message": "collector_id invalid", "error": "invalid_collector_id", "status": 400, "cause": null }

Lo que no estoy usando ahora es el access_token del marketplace, únicamente el access_token del vendedor, el marketplace_fee que lo tengo definido estático y listo.

Muchas gracias desde ya por tu ayuda, un saludo.
Tomás

@josebuffalo
Copy link

revisa la configuracion de la aplicacion en mercadopago, tiene que estar definida como MARKETPLACE para tener collector_id definido.

@agustinzamar
Copy link

Buenas colegas, gracias por compartir esta información. Quería hacer una consulta, me encuentro trabajando con la API de checkout de MP y puedo configurar todas las opciones sin problema, salvo marketplace_fee. En la documentación oficial https://www.mercadopago.com.co/developers/es/reference/preferences/_checkout_preferences/post dice que solo se puede enviar si esta configurado un marketplace valido (otra propiedades dentro de la preferencia).

Mi consulta seria si alguno sabe a que hace referencia el campo marketplace y donde se obtiene el string (campo alfanumérico) para indicarlo?

Desde ya muchas gracias por la ayuda.

Hola, como estas? Año 2023 y sigue sin decir nada la documentacion oficial. Pudiste resolver eso? De donde se obtiene el valor del campo marketplace?

@plencovich
Copy link
Author

Buenas colegas, gracias por compartir esta información. Quería hacer una consulta, me encuentro trabajando con la API de checkout de MP y puedo configurar todas las opciones sin problema, salvo marketplace_fee. En la documentación oficial https://www.mercadopago.com.co/developers/es/reference/preferences/_checkout_preferences/post dice que solo se puede enviar si esta configurado un marketplace valido (otra propiedades dentro de la preferencia).
Mi consulta seria si alguno sabe a que hace referencia el campo marketplace y donde se obtiene el string (campo alfanumérico) para indicarlo?
Desde ya muchas gracias por la ayuda.

Hola, como estas? Año 2023 y sigue sin decir nada la documentacion oficial. Pudiste resolver eso? De donde se obtiene el valor del campo marketplace?
@agustinzamar
marketplace_fee es la comisión que vas a cobrar

marketplace_fee
number
Tarifa de Marketplace cobrada por el propietario de la aplicación. Es una cantidad fija y su valor por defecto es 0 en moneda local. Esta propiedad solo se puede enviar si también se ha definido un marketplace válido; de lo contrario, la solicitud fallará.

Lo dice en el link que citas: https://www.mercadopago.com.co/developers/es/reference/preferences/_checkout_preferences/post

@agustinzamar
Copy link

Buenas colegas, gracias por compartir esta información. Quería hacer una consulta, me encuentro trabajando con la API de checkout de MP y puedo configurar todas las opciones sin problema, salvo marketplace_fee. En la documentación oficial https://www.mercadopago.com.co/developers/es/reference/preferences/_checkout_preferences/post dice que solo se puede enviar si esta configurado un marketplace valido (otra propiedades dentro de la preferencia).
Mi consulta seria si alguno sabe a que hace referencia el campo marketplace y donde se obtiene el string (campo alfanumérico) para indicarlo?
Desde ya muchas gracias por la ayuda.

Hola, como estas? Año 2023 y sigue sin decir nada la documentacion oficial. Pudiste resolver eso? De donde se obtiene el valor del campo marketplace?
@agustinzamar
marketplace_fee es la comisión que vas a cobrar

marketplace_fee
number
Tarifa de Marketplace cobrada por el propietario de la aplicación. Es una cantidad fija y su valor por defecto es 0 en moneda local. Esta propiedad solo se puede enviar si también se ha definido un marketplace válido; de lo contrario, la solicitud fallará.

Lo dice en el link que citas: https://www.mercadopago.com.co/developers/es/reference/preferences/_checkout_preferences/post

Exacto pero ese campo debe ir acompañado del otro que se llama solo 'marketplace' como muestra la documentacion, es necesario indicar un marketplace valido pero no explica de donde sale ese valor alfanumerico

image

@plencovich
Copy link
Author

@agustinzamar si, pero no hace falta poner nada; ya que si usas el access_token de la persona que queres cobrar en nombre de, va vacio.
cuando el vendedor conecta su cuenta de mercadopago a tu "tienda", vos obtenes la credencial del vendedor; y utilizas ese access_token a la hora de cobrar.

@MartinOliverio
Copy link

@apastrana-auntap @agustinzamar buenas, de casualidad buscando sobre otra duda que tengo sobre marketplace me encontré con esto, y es algo que también me trabó y que pude resolver a base de deducción porque la documentación no lo indica:

El marketplace está compuesto del String "MP-MKT-{$clientId}"

Por ejemplo si nuestro client Id es 6295877106812064, el marketplace será:

MP-MKT-6295877106812064

Espero les sirva, saludos!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment