README

• 安装
• 基本结账
• 自定义结账

安装

通过Composer

$ composer require fedeisas/mercadopago-sdk-php

或在项目的composer.json中作为依赖项

{
    "require": {
        "fedeisas/mercadopago-sdk-php": "1.0"
    }
}

基本结账

配置您的凭据

• 在以下地址获取您的 CLIENT_ID 和 CLIENT_SECRET
  • 阿根廷: https://www.mercadopago.com/mla/herramientas/aplicaciones
  • 巴西: https://www.mercadopago.com/mlb/ferramentas/aplicacoes
  • 墨西哥: https://www.mercadopago.com/mlm/herramientas/aplicaciones
  • 委内瑞拉: https://www.mercadopago.com/mlv/herramientas/aplicaciones
  • 哥伦比亚: https://www.mercadopago.com/mco/herramientas/aplicaciones
  • 智利: https://www.mercadopago.com/mlc/herramientas/aplicaciones

use MercadoPago\MercadoPago;
use MercadoPago\Http\GuzzleClient;

$mp = new MercadoPago(new GuzzleClient());
$mp->setCredentials('CLIENT_ID', 'CLIENT_SECRET');

偏好设置

获取现有的结账偏好

$preference = $mp->getPreference('PREFERENCE_ID');

var_dump($preference);

创建结账偏好

$preference_data = [
    'items' => [
        [
            'title' => 'Test',
            'quantity' => 1,
            'currency_id' => 'USD',
            'unit_price' => 10.4,
        ]
    ]
];

$preference = $mp->createPreference($preference_data);

var_dump($preference);

更新现有的结账偏好

$preference_data = [
    'items' => [
        [
            'title' => 'Test Modified',
            'quantity' => 1,
            'currency_id' => 'USD',
            'unit_price' => 20.4,
        ]
    ]
];

$preference = $mp->updatePreference('PREFERENCE_ID', $preference_data);

var_dump($preference);

支付/收款

搜索支付

$filters = [
    'id' => null,
    'site_id' => null,
    'external_reference' => null,
];

$searchResult = $mp->searchPayments($filters);

var_dump($searchResult);

获取支付数据

use MercadoPago\MercadoPago;
use MercadoPago\Http\GuzzleClient;

$mp = new MercadoPago(new GuzzleClient());
$mp->setCredentials('CLIENT_ID', 'CLIENT_SECRET');
$paymentInfo = $mp->getPayment('PAYMENT_ID');

var_dump($paymentInfo);

取消（仅适用于待处理支付）

$result = $mp->cancelPayment('PAYMENT_ID');

var_dump($result);

退款（仅适用于已认可支付）

$result = $mp->refundPayment('PAYMENT_ID');

var_dump($result);

自定义结账

使用访问令牌

use MercadoPago\MercadoPago;
use MercadoPago\Http\GuzzleClient;

$mp = new MercadoPago(new GuzzleClient());
$mp->setAccessToken('SOME_ACCESS_TOKEN');

创建支付

$mp->getClient()->post(
    '/v1/payments',
    $paymentData,
    ['access_token' => 'SOME_ACCESS_TOKEN']
);

创建客户

$mp->getClient()->post(
    '/v1/customers',
    ['email' => 'email@test.com'],
    ['access_token' => 'SOME_ACCESS_TOKEN']
);

获取客户

$mp->getClient()->get(
    '/v1/customers/CUSTOMER_ID',
    [],
    ['access_token' => 'SOME_ACCESS_TOKEN']
);

• 在开发者网站上查看更多与自定义结账相关的API
  • 阿根廷: https://www.mercadopago.com.ar/developers
  • 巴西: https://www.mercadopago.com.br/developers
  • 墨西哥: https://www.mercadopago.com.mx/developers
  • 委内瑞拉: https://www.mercadopago.com.ve/developers
  • 哥伦比亚: https://www.mercadopago.com.co/developers

测试

$ composer test

贡献

请参阅CONTRIBUTING和CONDUCT以获取详细信息。

安全

如果您发现任何与安全相关的问题，请通过电子邮件federicoisas@gmail.com而不是使用问题跟踪器。

鸣谢

• Fede Isas
• 所有贡献者

许可

MIT许可证（MIT）。有关更多信息，请参阅许可文件。