
Go 클라이언트 연동
표준 라이브러리만 사용합니다. 입금 주소를 생성하고 각 콜백의 서명을 검증합니다.
API 빠른 시작 보기요구 사항
- Go 1.24 이상이 필요합니다. 클라이언트는 표준 라이브러리만 사용합니다.
- 게이트웨이 기본 URL, 정산 지갑, 공개 콜백 URL이 필요합니다. 공개 호출에는 API 키가 필요하지 않습니다.
설치와 설정
- 모듈에 github.com/Suawave-Payment-System/suawave/sdk/go를 추가하고 suawave로 import하세요.
- suawave.New에 게이트웨이 기본 URL을 전달해 클라이언트를 생성하세요. 공개 작업의 인증 정보는 비워 두세요.
- 주문마다 티커, 정산 주소, 고유 콜백 URL로 PublicCreate를 호출하세요. 애플리케이션에 AddressIn과 필요한 토큰 금액을 표시하세요.
- PublicCallbackKey를 한 번 가져와 캐시하세요. VerifyRequest는 콜백 원본 바이트를 검증합니다. 주문 업데이트와 같은 트랜잭션에서 콜백 UUID를 영구 저장하고, 저장된 이벤트에 AckPublicCallback으로 수신 확인하세요.
구매자에게 표시되는 화면
반환된 주소와 금액으로 애플리케이션에서 결제 화면을 구성합니다. 클라이언트는 API 호출과 콜백 검증을 제공하며 호스팅된 결제 화면이나 쇼핑몰 주문 자동 업데이트는 제공하지 않습니다.
결제 처리 방식
- PublicInfo, PublicLogs, PublicEstimate, PublicQRCode와 환산 헬퍼로 공개 API를 사용할 수 있습니다. 금액은 십진수 문자열로 유지합니다.
- 검증된 확정 콜백을 받은 뒤에만 주문을 이행하세요. 포함된 ReplayGuard는 단일 프로세스의 메모리에만 저장됩니다. 영속적인 주문 처리를 위해서는 데이터베이스에서 콜백 UUID별 고유성을 보장해야 합니다.