쿠파스

쿠파스 지원

무엇을 도와드릴까요?

쿠파스를 쓰다가 궁금한 점이나 문제가 생기면 아래 도움말을 먼저 확인해 주세요. 해결되지 않으면 이메일로 문의해 주세요.

문의하기

빠르게 확인할 수 있도록 기기 모델, OS 버전, 앱 버전(설정 화면 하단), 화면에 나온 오류 문구, 증상과 재현 방법을 함께 적어 주세요. 스크린샷을 보낼 때는 설정의 ‘금액 가리기’를 켜도 괜찮아요.

문의 메일에 API 키(특히 Secret Key)를 적지 마세요. 키 없이도 문제를 확인할 수 있어요.
me@leed.at로 문의하기

시작하기

  1. API 키 발급쿠팡 파트너스 → ‘추가 기능’ → ‘파트너스 API’에서 Access Key와 Secret Key를 발급받으세요. 자세한 방법
  2. 키 등록앱의 ‘API 키 등록’ 화면에 두 키를 붙여넣고 ‘확인하고 저장’을 누르세요. 쿠팡에 바로 확인한 뒤 저장해요.
  3. 알림 허용‘어제 실적 도착 알림’을 받으려면 알림을 허용하세요.
  4. 위젯 추가홈 화면이나 잠금 화면에 위젯을 추가하면 앱을 열지 않아도 어제 수익이 보여요.

키 없이 먼저 둘러보려면 첫 화면에서 ‘샘플 데이터로 둘러보기’를 누르세요.

API 키 오류 해결

‘API 키가 올바르지 않아요’

쿠팡이 키를 알아보지 못한 경우예요. Access Key와 Secret Key를 서로 바꿔 넣지 않았는지, 앞뒤 공백이나 줄바꿈 없이 전체를 복사했는지 확인하세요. 쿠팡 파트너스에서 키를 재발급받았다면 설정 > ‘키 교체’에서 새 키로 바꿔 주세요.

‘API를 사용할 권한이 없어요’

API 키는 쿠팡 파트너스 최종 승인 회원만 쓸 수 있어요. 쿠팡 파트너스에서 승인 상태를 확인하고, 최종 승인 뒤에 발급받은 키인지 확인하세요. 승인 상태나 계정 제한은 쿠팡 파트너스 고객센터에서 확인할 수 있어요.

‘기기 시간이 맞지 않아 요청이 거절됐어요’

쿠팡 API 요청 서명은 약 5분 동안만 유효해서, 기기 시계가 많이 틀리면 거절돼요. 기기 설정의 ‘날짜 및 시간’에서 자동 설정을 켠 뒤 다시 시도하세요.

‘API 호출 한도에 걸렸어요’

쿠파스는 한도에 걸리면 1시간 동안 다시 부르지 않아요. 같은 키를 다른 앱·서비스·프로그램에서도 쓰고 있다면 한도를 함께 쓰게 돼요. 쿠팡 정책상 한도를 크게 넘기면 일정 시간(최대 24시간) 이용이 정지될 수 있어요.

‘네트워크 연결을 확인해 주세요’ · ‘서버가 응답하지 않아요’

인터넷 연결을 확인해 주세요. 쿠팡 서버 문제라면 위젯이 15분쯤 뒤에 자동으로 다시 시도해요.

실적 반영 시간

쿠팡 파트너스 실적은 실시간이 아니에요. 전날 실적이 다음 날 오후 3~4시(한국 시간)쯤 한 번에 반영돼요.

  • 오후 3시 전: 그저께까지의 실적이 보이고, 위젯에는 ‘어제 실적은 오후 3시 이후’라고 표시돼요.
  • 오후 3시 이후: 30분 간격으로 확인하며, 반영 전에는 ‘어제 실적 반영 대기 중’이 표시돼요.
  • 반영되면 ‘어제 실적이 도착했어요’ 알림이 오고 위젯이 어제 실적으로 바뀌어요.
  • 어제 실적이 0원이라 쿠팡 리포트에 행이 없으면, 오후 6시 이후 어제 실적을 0원으로 표시해요.
  • 취소·반품이 생기면 이미 반영된 날의 숫자도 나중에 달라질 수 있어요. 최종 기준은 쿠팡 파트너스 리포트예요.

위젯이 갱신되지 않을 때

  • 오후 3시 전에는 일부러 쿠팡 API를 부르지 않아요. 어제 실적이 이미 반영된 날에는 다음 날 오후 3시까지 같은 숫자가 보이는 게 정상이에요.
  • 앱을 한 번 열면 위젯도 바로 갱신돼요. 위젯의 새로고침 버튼으로도 즉시 확인할 수 있어요.
  • 실제 갱신 시점은 운영체제가 정해요. iOS의 저전력 모드나 Android의 배터리 최적화는 갱신을 늦출 수 있어요.
  • 위젯에 ‘API 키를 확인해 주세요’가 보이면 키가 바뀌었거나 권한이 없어진 경우예요. 위젯을 눌러 키를 다시 등록하세요.
  • 위젯에 ‘API 키를 등록해 주세요’가 보이면 앱에서 키를 등록하거나 샘플 데이터를 켜 주세요.

iPhone 홈 화면에 추가

  1. 편집 모드홈 화면의 빈 곳을 길게 누르고 ‘편집’ → ‘위젯 추가’를 누르세요.
  2. 쿠파스 검색위젯 목록에서 ‘쿠파스’를 찾으세요.
  3. 크기 선택소형·중형·대형 중 원하는 크기를 골라 ‘위젯 추가’를 누르세요.

iPhone 잠금 화면에 추가

  1. 사용자화잠금 화면을 길게 누르고 ‘사용자화’ → ‘잠금 화면’을 선택하세요.
  2. 위젯 영역 선택시계 아래 위젯 영역이나 시계 위 날짜 영역을 누르세요.
  3. 쿠파스 추가‘쿠파스’에서 직사각형·원형·인라인 위젯을 골라 추가하세요.

Android 홈 화면에 추가

  1. 앱에서 바로 추가설정 > ‘홈 화면에 바로 추가’를 누르세요. 지원하는 런처에서는 바로 추가돼요.
  2. 직접 추가또는 홈 화면의 빈 곳을 길게 누르고 ‘위젯’ → ‘쿠파스’를 찾아 원하는 위치에 놓으세요.

실적 도착 알림이 오지 않을 때

  • 기기 설정에서 쿠파스 알림이 허용돼 있는지, 앱 설정의 ‘어제 실적 도착 알림’이 켜져 있는지 확인하세요.
  • 집중 모드나 방해 금지 모드에서는 알림이 보이지 않을 수 있어요.
  • 알림은 하루에 한 번, 어제 실적이 반영된 직후에만 보내요. 그 전에 앱을 열어 실적을 이미 봤다면 알림을 따로 보내지 않아요.
  • ‘금액 가리기’를 켜 두면 알림에 금액 없이 ‘실적을 확인해 보세요’라고만 표시돼요.

키 삭제와 데이터 삭제

쿠파스에는 회원 가입이나 개발자 서버가 없어서, 서버에서 지워야 할 계정이 없어요. 아래 순서대로 기기에서 모든 데이터를 지울 수 있어요.

  1. 앱에서 API 키 삭제설정의 API 키 항목에서 키를 삭제하세요. 이 기기에 저장된 키와 실적 캐시, 위젯 데이터가 함께 지워져요.
  2. 위젯 제거와 앱 삭제홈 화면·잠금 화면에서 위젯을 제거한 뒤 앱을 삭제하세요. iOS 키체인은 앱을 지워도 남을 수 있어 키를 먼저 삭제하는 것을 권장해요.
  3. 익명 통계·오류 보고 삭제 요청(선택)익명 사용 이벤트와 오류 보고의 삭제를 원하시면 me@leed.at으로 요청해 주세요. 확인에 필요한 정보를 안내해 드려요.

정책