프로덕션 접근 권한

1. 프로덕션 계정 등록

https://biz.sodagift.com에서 가입하세요. 프로덕션은 샌드박스와 완전히 분리되어 있습니다 — 계정, API 키, 카탈로그, 데이터가 모두 별도입니다.

2. KYC 심사 완료하기

프로덕션 API 키는 KYC(Know Your Customer) 심사가 완료된 후에만 발급할 수 있습니다.

1. 프로덕션 대시보드에서 Settings > Developer Settings로 이동해 Generate API Key를 클릭하면, 사업자 서류(법인 설립 문서, W-9, 은행 확인서 등) 제출 화면이 표시됩니다.
2. 심사가 승인되면 같은 화면에서 sodagift_live_ API 키를 발급합니다.

• 심사 기간: 보통 영업일 기준 1–2일이며, 추가 정보가 필요한 경우 최대 일주일까지 걸릴 수 있습니다. 담당 SodaGift 매니저를 통해 빠른 처리를 요청할 수 있습니다.
• 제한: 암호화폐, 도박 등 일부 업종은 지원되지 않습니다. 전체 목록은 [email protected]으로 문의하세요.

3. 연동을 프로덕션으로 전환

• Base URL: https://biz-sandbox-api.sodagift.com → https://biz-api.sodagift.com
• API 키: sodagift_test_... → sodagift_live_...
• 상품 카탈로그를 프로덕션에서 다시 조회하세요 — 상품 ID는 환경마다 다릅니다. 샌드박스 상품 ID를 절대 재사용하지 마세요.
• 첫 실주문 전에 계정을 충전하세요 (충전); 잔액이 없으면 주문이 account_balance_insufficient로 실패합니다.

출시 체크리스트

• API 키를 코드가 아닌 시크릿 매니저에 보관
• 모든 POST /v1/orders에 external_reference_id 전달 (중복 방지와 재시도)
• 429와 order_retry_needed를 재시도/백오프로 처리 (에러)
• 클라이언트를 초당 10회 미만으로 스로틀링 (요청 제한)
• 주문 전 상품 가용성(ON_SALE) 확인
• 잔액 모니터링 — 대량 발송 전 충전
• 바우처 링크/코드를 시크릿으로 취급하고 로그에 남기지 않기