Skip to main content
루비 SDK는 Ruby 애플리케이션에 Dodo Payments를 통합하는 간단하고 직관적인 방법을 제공합니다. Ruby 관습과 모범 사례를 따르며, 포괄적인 오류 처리, 페이지 매김 및 미들웨어 지원을 제공합니다.

설치

Gemfile에 gem을 추가하세요:
Gemfile
항상 최신 SDK 버전을 사용하여 최신 Dodo Payments 기능에 액세스하세요. 최신 상태를 유지하려면 bundle update dodopayments를 정기적으로 실행하세요.
그런 다음 실행하세요:
이 SDK는 Ruby 3.2.0 이상을 지원하며 포괄적인 타입, 오류 처리 및 재시도 메커니즘을 제공합니다.

빠른 시작

클라이언트를 초기화하고 체크아웃 세션을 생성하세요:
환경 변수를 사용하여 API 키를 안전하게 저장하세요. 절대 버전 관리에 커밋하거나 코드에 노출하지 마세요.

주요 기능

Ruby Conventions

Ruby 명명 규칙 및 관용 패턴을 따름

Elegant Syntax

Ruby 개발자에게 자연스럽게 느껴지는 깔끔하고 읽기 쉬운 API

Auto-Pagination

목록 응답을 위한 내장 자동 페이징 반복자

Type Safety

향상된 타입 안전성을 위한 선택적 Sorbet 타입

구성

타임아웃 구성

요청 타임아웃을 구성하세요:

재시도 구성

자동 재시도 동작을 구성하세요:

일반 작업

체크아웃 세션 생성

체크아웃 세션을 생성하세요:

고객 관리

고객 정보를 생성하고 검색하세요:

구독 처리

정기 구독을 생성하고 관리하세요:
POST /subscriptions (SDK의 subscriptions.create 메서드)는 deprecated입니다. 기존 통합에서는 계속 작동하지만, 새로운 통합에서는 Checkout Session을 통해 subscription을 생성해야 합니다.
billing에는 최소한 두 글자의 ISO country 코드가 필요합니다. customer는 기존 customer를 연결하기 위한 { customer_id: "..." } 또는 새 customer를 생성하기 위한 { email: "...", name: "..." }를 사용할 수 있습니다. product_price는 통화의 가장 낮은 단위로 표시됩니다.

페이지네이션

자동 페이지네이션

모든 페이지를 자동으로 순회합니다:

수동 페이지네이션

페이지네이션을 더 세밀하게 제어하려면 다음을 사용하세요:

오류 처리

다양한 Dodo Payments API 오류를 처리합니다:
애플리케이션이 대량 트래픽 상황을 원활하게 처리할 수 있도록 rate limit 오류에 대해 지수 백오프를 사용하는 retry 로직을 구현하세요.

Sorbet을 사용한 타입 안전성

타입 안전성이 보장되는 request parameters를 위해 Sorbet을 사용하세요:

고급 사용법

문서화되지 않은 Endpoints

문서화되지 않은 endpoints에 request를 보내세요:

문서화되지 않은 Parameters

문서화되지 않은 parameters를 전송하세요:

Rails 통합

Initializer 생성

config/initializers/dodo_payments.rb을 생성하세요:

Service Object 패턴

payment service를 생성하세요:

Controller 통합

Rails controllers에서 사용하세요:

Sinatra 통합

Sinatra applications에서 사용하세요:

리소스

GitHub Repository

소스 코드를 확인하고 기여하기

API Reference

전체 API 문서

Discord Community

도움을 받고 개발자와 소통하기

Report Issues

버그 신고 또는 기능 요청

지원

Ruby SDK에 도움이 필요하신가요?

기여

기여를 환영합니다! 시작하려면 기여 가이드라인을 확인하세요.
마지막 수정일 2026년 8월 17일