Version 1 Naver Billing

네이버 빌링 처리 process

네이버 상품 구매 등록

상품을 구매하기 전에, 구매를 위한 id를 발급 받는다.

• Path: /v1/naver_purchases
• Authentication Header: X-APP-KEY, X-AUTH-UUID, X-AUTH-TOKEN
• Method: POST
• Request Body:

Name	Type	Description
product_code	String	네이버에 등록된 상품의 code
purchased_item_key	String	구매의 후 변경될 유료 아이템의 key
purchased_item_add_value	Number	유료 아이템이 증가할 값

• Response Body: JSON

Name	Type	Description
result_code	Number	Error Code 참고
result_message	Option[String]	실패한 경우에 메시지 있을 수 있음
id	Number	구매 id

네이버 상품 구매 완료 처리

결제 일련번호를 확인하고, 정상 결제이면 앞서 설정된 유료 아이템 변경 값을 적용한다.

• Path: /v1/naver_purchases/complete/:id
• Authentication Header: X-APP-KEY, X-AUTH-UUID, X-AUTH-TOKEN
• Method: POST
• Request Parameter:

Name	Type	Description
id	Number	구매 등록시 발급 받은 구매 id

• Request Body:

Name	Type	Description
payement_sequence	String	네이버 결제 완료후 전달받은 paymentSeq 값

• Response Body: JSON

Name	Type	Description
result_code	Number	Error Code 참고
result_message	Option[String]	실패한 경우에 메시지 있을 수 있음
purchased_item	JSON Object	완료후 변경된 유료 아이템. json의 key에는 purchased_item의 key가, json의 value에는 purchased_item의 value가 세팅됨

유료 아이템 사용

유료 아이템을 사용하여 user data를 변경한다.

• Path: /v1/purchased_items/consume/:key
• Authentication Header: X-APP-KEY, X-AUTH-UUID, X-AUTH-TOKEN
• Method: POST
• Request Parameter:

Name	Type	Description
key	String	유료 아이템의 key

• Request Body:

Name	Type	Description
subtract_value	Number	사용으로 줄어 드는 유료 아이템의 값
change	JSON Array	유료 아이템 사용으로 변경되는 user data Name Type Description key String data의 key value String data의 value command Option[String] 'set', 'inc', 'dec' 중 하나. Default는 set 'inc'나 'dec'인 경우에 value의 string은 number로 전환 가능하여야 함

• Response Body: JSON

Name	Type	Description
result_code	Number	Error Code 참고
result_message	Option[String]	실패한 경우에 메시지 있을 수 있음
user_data	JSON data	key에 명시된 사용자 데이터들을 json 형태로 반환