메인 콘텐츠로 건너뛰기
루비 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 타입

구성

타임아웃 구성

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

재시도 구성

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

일반 작업

체크아웃 세션 생성

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

고객 관리

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

구독 처리

정기 구독을 생성하고 관리하세요:
billing 최소한 ISO 2자리 country 코드가 필요합니다. customer 기존 고객을 연결하기 위한 { customer_id: "..." } 또는 새 고객을 생성하기 위한 { email: "...", name: "..." } 중 하나를 허용합니다. product_price는 가장 낮은 통화 단위에 있습니다.

페이지 매김

자동 페이지 매김

모든 페이지를 자동으로 탐색하세요:

수동 페이지 매김

페이지 매김에 대한 더 많은 제어:

오류 처리

다양한 Dodo Payments API 오류 처리:
고용량 시나리오를 우아하게 처리할 수 있도록 속도 제한 오류에 대한 지수 백오프를 사용한 재시도 로직을 구현하세요.

Sorbet를 사용한 유형 안전성

타입 안전한 요청 파라미터를 위해 Sorbet 사용:

고급 사용법

문서화되지 않은 엔드포인트

문서화되지 않은 엔드포인트에 요청하기:

문서화되지 않은 매개변수

문서화되지 않은 매개변수 보내기:

레일즈 통합

초기화 파일 생성

config/initializers/dodo_payments.rb 생성하기:

서비스 오브젝트 패턴

결제 서비스를 생성하세요:

컨트롤러 통합

레일즈 컨트롤러에서 사용하기:

시나트라 통합

시나트라 애플리케이션과 함께 사용하기:

리소스

GitHub Repository

소스 코드 보기 및 기여하기

API Reference

전체 API 설명서

Discord Community

도움말 받기 및 개발자와 연결

Report Issues

버그 신고 또는 기능 요청

지원

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

기여

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