메인 콘텐츠로 건너뛰기

SDK 및 라이브러리

TypeScript, Python, Go, PHP, Java, Kotlin, C#, Ruby, React Native에 대한 공식 SDK를 사용하여 통합을 가속화하세요. 이러한 라이브러리는 API 요청, 인증 및 오류 처리를 단순화하여 훌륭한 결제 경험을 구축하는 데 집중할 수 있도록 합니다.

​
환경 URL

Test Mode vs Live Mode에 대해 자세히 알아보세요.

​
API 키 관리 및 인증

1

API 키 접근

대시보드에서 개발자 → API 키로 이동하여 키를 관리하세요.
2

새 키 생성

API 키 추가를 선택하고 설명적인 이름을 제공한 후 쓰기 권한을 구성하세요:
  • 쓰기 권한 활성화 (체크됨): 모든 API 작업에 대한 전체 읽기 및 쓰기 권한
  • 쓰기 권한 활성화 (체크 해제됨): 읽기 전용 액세스 - 데이터(결제, 구독, 고객, 제품)만 가져올 수 있습니다. 리소스를 생성하거나 수정할 수 없습니다.
대시보드 통합, 분석 도구 및 변경 없이 데이터 보기만 필요한 시스템의 경우 “쓰기 권한 활성화”의 체크를 해제하세요.
3

키를 안전하게 저장

생성된 키를 즉시 복사하고 안전하게 저장하세요.
4

API 요청 인증

API 키를 사용하여 모든 요청을 인증하세요. 다음 인증 형식을 적용하세요:
Authorization: Bearer YOUR_API_KEY
클라이언트 측 코드나 공개 리포지토리에서 비밀 API 키를 노출하지 마세요.

​
응답 형식

{
  "id": "pay_1234567890",
  "status": "completed",
  "amount": 2999,
  "currency": "USD",
  "created_at": "2024-01-15T10:30:00Z"
}

​
비율 제한

  • 표준: 비즈니스당 분당 1000 요청
  • 버스트: 초당 최대 100 요청
사용량을 추적하려면 X-RateLimit-Remaining 헤더를 모니터링하세요.

​
오류 처리

오류를 효과적으로 관리하려면 오류 코드 및 거래 실패 섹션을 참조하여 자세한 지침을 확인하세요.

오류 코드

포괄적인 오류 세부정보 및 해결 방법을 살펴보세요.

거래 실패

일반적인 거래 문제 및 해결 방법에 대한 통찰력을 얻으세요.

​
웹훅

결제 이벤트에 대한 실시간 알림을 받으세요. 설정 지침은 웹훅 가이드를 참조하세요.

웹훅 가이드

실시간 알림 및 이벤트 처리를 위한 웹훅을 설정하세요.