SumUp Rust SDK

IMPORTANT: This SDK is under heavy development and subject to breaking changes.

The Rust SDK for the SumUp API.

Requirements

Rust 1.82.0 or higher. We follow Firefox MSRV policy.

Installation

Install with:

cargo add sumup

Quick Start

use sumup::Client;

#[tokio::main]
async fn main() {
    // Initialize the client (reads SUMUP_API_KEY from environment)
    let client = Client::default();

    // List existing checkouts
    let checkouts = client
        .checkouts()
        .list(Default::default())
        .await
        .expect("list checkouts");
    println!("retrieved {} checkouts", checkouts.len());
}

Authentication

use sumup::{Authorization, Client};

// Read SUMUP_API_KEY from the environment
let client = Client::default();

// Or set an explicit API key
let client = Client::default()
    .with_authorization(Authorization::api_key("your_api_key"));

Examples

You can find all examples under examples/. To run an example, use:

cargo run --example checkout_card_reader