README

Mercado Pago SDK for PHP

此库为开发者提供了一套简单的绑定，帮助您将 Mercado Pago API 集成到网站中并开始接收支付。

💡 要求

SDK 支持 PHP 8.2 或更高版本。

💻 安装

如果您已经使用另一个版本的 Mercado Pago PHP SDK，请查看我们的从版本 2 到版本 3 的迁移指南。

第一次使用 Mercado Pago？如果您还没有，请创建您的Mercado Pago 账户。

如果尚未安装，请下载Composer。
在命令行中安装 Mercado Pago PHP SDK

composer require "mercadopago/dx-php:3.0.0"

您还可以运行 composer require "mercadopago/dx-php:2.6.1" 用于 PHP7.1 或 composer require "mercadopago/dx-php:1.12.5" 用于 PHP5.6。

将 access_token 复制到页面上的凭证部分，并用它替换 YOUR_ACCESS_TOKEN。

这样就完成了！Mercado Pago SDK 已成功安装。

🌟 开始使用

简单使用如下

<?php
    // Step 1: Require the library from your Composer vendor folder
    require_once 'vendor/autoload.php';

    use MercadoPago\Client\Payment\PaymentClient;
    use MercadoPago\Exceptions\MPApiException;
    use MercadoPago\MercadoPagoConfig;

    // Step 2: Set production or sandbox access token
    MercadoPagoConfig::setAccessToken("<ACCESS_TOKEN>");

    // Step 3: Initialize the API client
    $client = new PaymentClient();

    try {

        // Step 4: Create the request array
        $request = [
            "transaction_amount" => 100,
            "token" => "YOUR_CARD_TOKEN",
            "description" => "description",
            "installments" => 1,
            "payment_method_id" => "visa",
            "payer" => [
                "email" => "user@test.com",
            ]
        ];

        // Step 5: Make the request
        $payment = $client->create($request);
        echo $payment->id;

    // Step 6: Handle exceptions
    } catch (MPApiException $e) {
        echo "Status code: " . $e->getApiResponse()->getStatusCode() . "\n";
        echo "Content: " . $e->getApiResponse()->getContent() . "\n";
    } catch (\Exception $e) {
        echo $e->getMessage();
    }

第 1 步：从您的 Composer 供应商文件夹中引入库

require_once 'vendor/autoload.php';

use MercadoPago\Client\Payment\PaymentClient;
use MercadoPago\Exceptions\MPApiException;
use MercadoPago\MercadoPagoConfig;

第 2 步：设置生产或沙盒访问令牌

MercadoPagoConfig::setAccessToken("<ACCESS_TOKEN>");

您还可以设置其他属性，如重试次数、跟踪头、超时和自定义 HTTP 客户端。

第 3 步：初始化 API 客户端

$client = new PaymentClient();

第 4 步：创建请求数组

$request = [
    "transaction_amount" => 100,
    "token" => "YOUR_CARD_TOKEN",
    "description" => "description",
    "installments" => 1,
    "payment_method_id" => "visa",
    "payer" => [
        "email" => "user@test.com",
    ]
];

第 5 步：发出请求

$payment = $client->create($request);

第 6 步：处理异常

...
// Handle API exceptions
} catch (MPApiException $e) {
    echo "Status code: " . $e->getApiResponse()->getStatusCode() . "\n";
    echo "Content: " . $e->getApiResponse()->getContent() . "\n";

// Handle all other exceptions
} catch (\Exception $e) {
    echo $e->getMessage();
}

📚 文档

请参阅我们的文档以获取更多详细信息。

Mercado Pago 参考API。葡萄牙语 / 英语 / 西班牙语

🤝 贡献

所有贡献都受欢迎，包括那些想要整理问题的人、想要编写文档的人以及想要贡献代码的人。

请阅读并遵循我们的贡献指南。不符合这些指南的贡献将被忽略。这些指南是为了让我们的生活更轻松，并使贡献过程对每个人来说都是一致的。

2.x.x 版本的补丁

自 3.0.0 版本发布以来，版本 2 已被弃用，不会接收新功能，只会修复错误。如果您需要为该版本提交 PR，请使用 master-v2 作为您的基分支。

❤️ 支持

如果您需要技术支持，请通过我们的开发者网站联系我们的支持团队：英语 / 葡萄牙语 / 西班牙语

🏻 许可证

MIT license. Copyright (c) 2023 - Mercado Pago / Mercado Libre
For more information, see the LICENSE file.

climba-commerce / mercadopago-sdk-php

维护者

详细信息