Mileage (적립금) 선택

• 리뷰 적립금 지급용으로 사용 계획이 없다면 생략 가능(구현 여부를 크리마에 알려주세요)
• 작업 내용 설명: 실시간으로 크리마 관리자에서 적립금 지급 실행 시 callback URL로 크리마 → 쇼핑몰 개발사로 호출

Mileage 개발 후 검수 방법

<aside> 🚨 MileageAPI 검수는 크리마 스크립트가 모두 설치된 이후에만 가능합니다. 아직 스크립트 설치를 진행하지 않았다면 우선 넘어가고, 설치 완료 후 다시 확인해주세요!

</aside>

1. Mileage API 문서를 참고하여 Callback URL을 만드시고, 크리마 관리자페이지 > 리뷰 설정 > 적립금 설정 최하단 적립금 지급을 위한 지급 요청 URL에 생성된 URL을 입력해주세요.

   • ex) https://aaaer23rlkdf.com/api/crema/addCremaReviewPoint

   

2. 스크립트를 설치하면서 저희 담당자에게 공유해주신 테스트 아이디로 리뷰를 작성해주세요.

   1. 작성 가능한 위치
      1. 쇼핑몰 내 마이페이지 > 내 리뷰 위젯 > 작성 버튼
      2. 쇼핑몰 상품 상세 하단에 리뷰 위젯 > 리뷰 작성하기 영역 및 버튼
      3. 쇼핑몰 메인, 상품상세에 접근 시 뜨는 작성 유도 팝업

3. 리뷰 목록에서 작성한 리뷰의 우측 적립금 지급 버튼을 클릭해 지급합니다.

   

   • 예상 적립금이 0인 경우는 예상 적립금을 수정한 후 지급해봅니다. (0원인 경우 지급할 것이 없기 때문에 callback URL로 호출이 되지 않습니다)

   • 적립금 지급과 회수 모두 가능해야하기에 회수 테스트도 필요합니다. 지급을 하고나면 '지급 취소'를 눌러 회수해봅니다.

     

4. 지급 실패 시, 에러 Alert를 노출하는데요. 이때, 공유주셨던 callbackURL에서 오는 리턴 값을 그대로 반환하고 있습니다. 따라서, 어떤 사유로 지급이 실패하는지 직접 확인하시고, 들어온 로그 체크하시면서 코드 수정해주시면 됩니다.

   • callbackURL에서 리턴된 내용임에도 원인을 모르겠고, 로그를 봐도, 적립금 개발자문서를 확인해봐도, 원인을 파악하기 어렵다면 크리마API 소통 담당자에게 지급 시각, 지급한 리뷰 링크, 들어온 호출 로그와 함께 메일로 전달해주시면 저희쪽에서 살펴볼 수 있는게 있는지 확인해보겠습니다.

5. 해당 고객의 쇼핑몰 > 마이페이지 > 적립금 지급 내역에 지급한 금액, 회수한 금액이 내역으로 모두 뜨는지 확인합니다.

6. 크리마 API 담당자에게 다음 사항을 전달하여 확인 요청해주세요.

   • 지급 테스트한 ID, PW (내역을 크리마 내부에서도 확인해보기 위함)
   • 검수 완료 여부

주의 사항

• 크리마 테스트서버를 사용하는 경우, 또는 운영 호스팅사를 변경하는 경우
  • 크리마 테스트서버는 안전을 위해 적립금 실지급이 막혀있습니다. 검수 가능한 시점을 알려주시면 해당 시간동안 임시로 테스트서버 실지급을 오픈해드립니다.
  • 테스트를 위한 크리마 관리자 접근법
    • 테스트서버 주소: https://sadmin.cre.ma
    • ID, PW: 라이브서버와 동일

참고: Mileage API 에 대한 이해

• 제공해주시는 적립금 callback_url 의 end point 주소가 http://aaa.co.kr/crema/mileage 라고 가정하고 설명드리겠습니다.

1. 이 URL 을 제공해주시면, 크리마 어드민에서 적립금 지급 발생 시 아래와 같은 예시로 적립금 요청을 하게 됩니다.
   • curl --location --request POST 'http://aaa.co.kr/crema/mileage' \--header 'Content-Type: application/x-www-form-urlencoded' \--data-urlencode 'user_code=[email protected]' \--data-urlencode 'amount=100' \--data-urlencode 'message=test_mileage' \--data-urlencode 'product_code=test_product_code' \--data-urlencode 'review_code=1' \--data-urlencode 'order_code=test_order_code'
2. 그러면 이 요청을 받은 뒤 지급 처리한 뒤 응답 내용으로 https://dev.cre.ma/crema-api/mileage 하단에 적혀있는 예시처럼 JSON 형태로 결과를 반환해주세요.
   • { "code": 0, "message": "success"}
3. 그리고 실패하는 경우에는 적절한 오류 code 값과 message 내용을 채워주시면 됩니다.

자주 묻는 질문

[크리마 dev.cre.ma FAQ](https://cremafactory.notion.site/dev-cre-ma-FAQ-1dda98183bdc8094aae4cdd165579ce4)

<aside> 👉🏻 다음 문서: 크리마 담당자에게 최종 검수 요청

</aside>