arlyon/async-stripe

Stripe API를 Rust에서 비동기로 호출하는 타입 안전 라이브러리

개발 재료맘대로 써도 됨 · Apache-2.0커머스·결제Rust난이도

7570 찜

187포크8이슈

중간맛 분석

Stripe HTTP 를 Rust 비동기 코드에서 호출하는 라이브러리입니다. Stripe 공식 OpenAPI 명세에서 코드를 자동 생성하고 가 매주 최신 스펙을 반영하므로 새 기능이 신속하게 추가됩니다. 요청 직렬화는 serde, 응답 역직렬화는 miniserde를 사용해 컴파일 시간과 바이너리 크기를 최소화합니다. 모듈식 구조로 stripe-core(고객·결제), stripe-billing(청구), stripe-(웹훅) 등을 분리했으므로 필요한 부분만 포함할 수 있습니다. 빌더 패턴 로 요청을 구성하고, 페이지네이션·웹훅 처리가 내장되어 있습니다. 설치 후 STRIPE_SECRET_KEY 환경변수를 설정하고 Cargo.toml에서 런타임(tokio/async-std)과 TLS(native-tls/rustls) 기능을 선택해 사용합니다.

이런 레포예요

이럴 때 쓰면 좋아요

Rust 웹 애플리케이션에서 Stripe 고객·결제·구독 API 호출
Stripe 웹훅을 받아 주문 상태 업데이트 및 영수증 발송
결제 플랫폼 또는 SaaS에서 여러 고객의 청구 관리

핵심 기능

공식 Stripe OpenAPI 명세 기반 매주 자동 생성miniserde로 빠른 역직렬화 및 작은 바이너리 크기기능별 모듈식 크레이트 구조로 필요한 부분만 선택

대안 대비 차별점

공식 명세 기반 자동 생성으로 새 Stripe API가 거의 실시간으로 포함되며, miniserde 사용으로 수동 작성 바인딩 라이브러리 대비 컴파일 시간과 바이너리 크기를 크게 줄입니다.

먹어본 사람들

실제로 차려 먹어본 손님들의 흔적이에요 — 한마디와 완주 인증 모두 검수 후 공개돼요.

시식평 · 먹어본 사람 한마디

아직 시식평이 없어요. 먹어보셨다면 첫 한마디를 남겨주세요.

다른 레포 시식평 구경하기 →

이 레포로 만든 것들

🖋 완주 인증하기

아직 이 레포로 만든 완주 인증이 없어요. 첫 밥도장을 찍어보세요!

이 레포, 해먹는 법

처음 오셨어요? 어렵지 않아요 — 위에서 아래로 따라 하면 내 컴퓨터에 이 레포를 차려서 바로 맛볼 수 있어요.

준비물

Stripe API 키
Rust 1.56 이상
tokio 또는 async-std 런타임 (선택)

바로 차려먹기Rust (cargo)

깃밥이 레포 구조를 확인하고 만든 실행 명령이에요. 터미널에 붙여넣으면 받기부터 실행까지 한 번에 진행돼요.

git clone --depth 1 https://github.com/arlyon/async-stripe.git &&
cd async-stripe &&
cargo run

코드는 내 컴퓨터에서 실행돼요 — 처음 보는 레포라면 내용을 한번 훑어보고 실행하는 습관을 추천해요.

README가 안내하는 자세한 단계 보기

의존성 추가 - Cargo.toml에 async-stripe와 stripe-core, tokio 추가

[dependencies]
async-stripe = "=1.0.0-rc.5"
async-stripe-core = { version = "=1.0.0-rc.5", features = ["customer"] }
tokio = { version = "1", features = ["full"] }

Stripe API 키 환경변수 설정

export STRIPE_SECRET_KEY="your_stripe_secret_key"

Rust 코드에서 고객 생성

use stripe::Client;
use stripe_core::customer::CreateCustomer;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let secret_key = std::env::var("STRIPE_SECRET_KEY")?;
    let client = Client::new(secret_key);
    let customer = CreateCustomer::new()
        .name("John Doe")
        .email("john@example.com")
        .send(&client)
        .await?;
    println!("Customer created: {}", customer.id);
    Ok(())
}