#payment-gateway #sdk #api #strongly-typed #error #mercado-pago #mercadopago

mercadopago-sdk-rust

A strongly-typed wrapper for MercadoPago payment gateway API

2 releases

0.1.1 May 15, 2022
0.1.0 May 15, 2022

#6 in #payment-gateway

MIT license

38KB
825 lines

MercadoPago SDK

Crate version on crates.io Crate documentation on docs.rs Crate license

An open source, strongly-typed SDK for the MercadoPago API.

It will try to hold your hand and reduce the possibility of errors, providing the correct API surface.

Note

The library is still under development and its public API is subject to change.

Installation

Added the following into your Cargo.toml:

mercadopago_sdk_rust = "0.1"

Usage

The client is built using the MercadoPagoSDKBuilder::with_token with_token method.

use mercadopago_sdk_rust::{MercadoPagoSDK, MercadoPagoSDKBuilder};

let mp_sdk: MercadoPagoSDK = MercadoPagoSDKBuilder::with_token("MP_ACCESS_TOKEN");

Once the token is inserted, you can call methods on crate::MercadoPagoSDK

Creating a CheckoutPro Preference

use mercadopago_sdk_rust::common_types::{CheckoutProPayer, Item};
use mercadopago_sdk_rust::payments::requests::DocumentType;
use mercadopago_sdk_rust::preferences::requests::CheckoutProPreferences;
use mercadopago_sdk_rust::MercadoPagoSDKBuilder;

#[tokio::main]
async fn async_main() {
    let mp_sdk = MercadoPagoSDKBuilder::with_token("MP_ACCESS_TOKEN");

    let sample_item =
        Item::minimal_item("Sample item".to_string(), "".to_string(), 15.00, 1).unwrap();

    let preferences = CheckoutProPreferences::new()
        .set_items(vec![sample_item])
        .set_payer(CheckoutProPayer::minimal_payer(
            "fulano@beltrano.com.br".to_string(),
            DocumentType::CPF,
            41810524485,
        ));

    mp_sdk
        .create_preferences_checkout_pro(preferences)
        .expect("Failed to validate checkout preference. Something is wrong.")
        .execute()
        .await
        .unwrap();
}

Other Examples

Check out the tests folder inside our repository to check for more examples.

License

Project is licensed under the permissive MIT license.

Dependencies

~7–21MB
~317K SLoC