Flutter多功能集成插件mp_integration的使用

使用

要使用此插件，在您的 pubspec.yaml 文件中添加 mp_integration 作为依赖项。

• 基础结账
• 自定义结账
• 通用方法

基础结账

配置您的凭证

获取您的 <strong>CLIENT_ID</strong> 和 <strong>CLIENT_SECRET</strong>：

• 阿根廷: 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

import 'package:mp_integration/mp_integration.dart';

var mp = MP("CLIENT_ID", "CLIENT_SECRET");

实例化仅使用访问令牌

var mp = MP.fromAccessToken("TOKEN");

偏好设置

获取现有的结账偏好设置

Future<Map<String, dynamic>> index() async {
    var result = await mp.getPreference("PREFERENCE_ID");

    return result;
}

创建一个结账偏好设置

Future<Map<String, dynamic>> index() async {
    var preference = {
        "items": [
            {
                "title": "测试",
                "quantity": 1,
                "currency_id": "USD",
                "unit_price": 10.4
            }
        ]
    };

    var result = await mp.createPreference(preference);

    return result;
}

更新现有的结账偏好设置

Future<Map<String, dynamic>> index() async {
    var preference = {
        "items": [
            {
                "title": "修改后的测试",
                "quantity": 1,
                "currency_id": "USD",
                "unit_price": 20.4
            }
        ]
    };

    var result = await mp.updatePreference(id, preference);

    return result;
}

支付/收集

查找支付

Future<Map<String, dynamic>> index() async {
    var filters = {
        "id": null,
        "external_reference": null
    };

    var searchResult = await mp.searchPayment(filters);

    return searchResult;
}

获取支付数据

Future<Map<String, dynamic>> index() async {
    var paymentInfo = await mp.getPayment("PID");

    return paymentInfo;
}

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

Future<Map<String, dynamic>> index() async {
    var result = await mp.cancelPayment("PID");

    // 显示结果
    return result;
}

退款支付（仅适用于已批准的支付）

Future<Map<String, dynamic>> index() async {
    var result = await mp.refundPayment("PID");

    // 显示结果
    return result;
}

自定义结账

配置您的凭证

获取您的 <strong>ACCESS_TOKEN</strong>：

• 阿根廷: https://www.mercadopago.com/mla/account/credentials
• 巴西: https://www.mercadopago.com/mlb/account/credentials
• 墨西哥: https://www.mercadopago.com/mlm/account/credentials
• 委内瑞拉: https://www.mercadopago.com/mlv/account/credentials
• 哥伦比亚: https://www.mercadopago.com/mco/account/credentials

import 'package:mp_integration/mp_integration.dart';

var mp = MP("ACCESS_TOKEN");

创建支付

mp.post("/v1/payments", data);

创建客户

mp.post("/v1/customers", {"email": "email@test.com"});

获取客户

mp.get("/v1/customers/CUSTOMER_ID");

您可以查看更多与自定义结账相关的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

通用方法

您可以使用以下通用方法访问MercadoPago API的任何其他资源：

// 获取资源，可选URL参数。也可以禁用公共API的身份验证
mp.get("/resource/uri", { params, authenticate });

// 使用"data"创建资源并可选URL参数。
mp.post("/resource/uri", { data, params });

// 使用"data"更新资源并可选URL参数。
mp.put("/resource/uri", { data, params });

// 删除资源并可选URL参数。
mp.delete("/resource/uri", { params });

例如，如果想获取站点列表（无参数且无需身份验证）：

var result = mp.get("/sites");

print(result);

示例代码

import 'package:flutter/foundation.dart';
import 'package:mp_integration/mp_integration.dart';

void main() async {
  var mp = MP('CLIENT_ID', 'CLIENT_SECRET');

  String? token = await mp.getAccessToken();

  if (kDebugMode) {
    print('Mercadopago token $token');
  }
}