한국어
시작하기 개요
OOLIN은 API로 디지털 자산 지갑을 구현할 수 있는 인프라입니다. 고객사 서비스에 계정을 연결하고, 외부 입금과 잔액 조회, 계정 간 이체, 외부 출금과 거래 기록을 하나의 흐름으로 구성할 수 있습니다.
이 섹션에서는 연동 환경과 자격 증명을 준비하고 첫 인증 요청을 실행합니다. 이후 Wallet 튜토리얼에서 테스트넷 입출금을 구현하고, 필요하면 같은 지갑 기능을 Digital Payment의 결제·정산에 활용합니다.
OOLIN으로 구현할 수 있는 기능
| 기능 | 고객사 서비스에서의 활용 | 관련 개념 |
|---|---|---|
| 계정 준비 | 고객·사업자와 지갑 계정을 연결하고 재사용 | 사용자·계정·지갑 모델 |
| 입금 | 자산·네트워크별 입금 목적지를 안내하고 수취 결과 확인 | 입금 주소, 입금 처리 흐름 |
| 잔액과 거래 기록 | 사용 가능 자금과 금액 변동 내역 표시 | 잔액과 원장 |
| 외부 출금 | 외부 지갑으로 자산을 보내고 완료 결과 추적 | 출금 처리 흐름 |
| 내부이체 | OOLIN 계정 간 자금 이동과 고객·가맹점 결제 | OOLIN 서비스 구조 |
네트워크와 자산의 이용 가능 범위는 고객사별로 확인합니다. 지원 네트워크는 메인넷과 테스트넷을 나누어 안내하며, 고객사의 요청에 따라 네트워크를 확장할 수 있습니다.
연동 구조
고객 앱은 고객사 백엔드를 호출하고, 백엔드는 고객의 작업 권한을 확인한 뒤 OOLIN Wallet API에 서명된 요청을 보냅니다.
text
고객 앱
→ 고객사 백엔드: 고객 인증·작업 권한 확인·요청 서명
→ OOLIN Wallet API: 계정·입금·잔액·이체·출금
→ 고객사 백엔드: 거래 결과 조회·업무 상태 반영
→ 고객 앱: 잔액과 거래 진행 상황 표시API Key는 고객사 연동을 식별하고 HMAC Key는 요청 내용에 서명하는 데 사용합니다. 두 자격 증명은 서버 측에서 관리합니다. 고객의 로그인·주문·업무 상태는 고객사 서비스에서 관리하고 OOLIN의 계정·거래 ID와 연결합니다. 자세한 역할은 OOLIN 서비스 구조에서 설명합니다.
시작 전에 준비할 것
- 연동 환경과 자격 증명: BPMG 온보딩 채널에서 테스트용 Base URL, API Key, HMAC Key와 지원 연락처를 전달받습니다.
- 고객사 백엔드: HTTPS 요청과 HMAC 서명, 서버 측 비밀 저장소, 시각 동기화를 준비합니다.
- 테스트할 자산과 네트워크: 이용 가능한 조합과 테스트 자산 준비 방법을 확인합니다. 문서의 예제는 Ethereum Sepolia 테스트넷을 사용합니다.
- 예제 실행 도구: Quickstart와 튜토리얼에는 Node.js,
curl,openssl,jq를 사용합니다. 운영 연동은 고객사 백엔드의 언어로 구현할 수 있습니다.
API의 개발·테스트·운영 환경과 블록체인의 메인넷·테스트넷은 별개의 구분입니다. 계정·자산·네트워크 ID와 자격 증명은 대상 환경의 값을 사용합니다.
첫 연동의 순서
| 순서 | 문서 | 이 단계에서 확인할 결과 |
|---|---|---|
| 1 | 연동 환경과 Base URL | 호출할 환경과 이용할 네트워크·자산 확인 |
| 2 | API 자격 증명 | API Key와 HMAC Key의 역할·보관 방식 확인 |
| 3 | HMAC 인증 개요 | 서명에 필요한 요청 정보와 인증 헤더 이해 |
| 4 | 첫 번째 API 호출 | 서버 시각을 확인하고 활성 네트워크 조회 성공 |
| 5 | Quickstart | wallet_request를 준비하고 계정·입금 주소·잔액 조회까지 실행 |
바로 예제를 실행하려면 Quickstart에서 환경 변수와 wallet_request 함수를 준비합니다. 이 함수는 튜토리얼에서 HMAC 인증 요청을 실행하는 공통 셸 도구입니다.
만들려는 서비스에 맞는 튜토리얼
| 목적 | 다음 문서 | 구현할 흐름 |
|---|---|---|
| 고객 지갑 | Wallet 튜토리얼 | 계정 준비 → 입금 주소 → 테스트넷 입금 → 잔액·원장 → 외부 출금 |
| 고객·가맹점 결제 | Digital Payment 튜토리얼 | 고객 충전 → 내부결제 → 가맹점 수취 → 외부 정산 → 거래 대사 |
계정, 주소, 잔액과 거래의 관계를 먼저 이해하려면 핵심 개념을 확인합니다. 요청·응답의 전체 필드는 API Reference에서 조회합니다.
연동 검증과 다음 단계
첫 인증 요청이 성공하면 연결과 인증을 확인한 것입니다. 지갑 기능의 검증은 테스트넷에서 실제 입출금과 거래 기록까지 확인하며 진행합니다.
- 고객과 계정, 선택한 자산·네트워크·입금 목적지의 연결을 저장합니다.
- 입금·출금 상세의 완료 상태를 확인하고 잔액·원장과 비교합니다.
- 생성 응답이 유실되어도 저장한 ID로 기존 결과를 조회하고 중복 요청을 복구할 수 있는지 확인합니다.
- 서비스 재시작 후에도 신규 거래 조회와 진행 중인 거래의 상태 추적을 이어갈 수 있는지 확인합니다.
운영 환경을 준비할 때는 보안 권장사항, 오류 처리와 재시도, 멱등성과 중복 요청 방지를 적용합니다. 환경·자산 준비나 연동 범위에 대한 문의는 지원 문의를 이용합니다.