Friend Smash Coin

====== 페이스북 앱 개발 - 결제 ====== 페이스북이 제공하는 결제 시스템에 대해 정리한다. ===== 회사 등록 ===== 결제 시스템 이용 전에 Apps - Payments 페이지를 통해 회사 정보 / 은행 계좌 정보를 등록해야 한다. [[https://developers.facebook.com/docs/howtos/payments/companyregistration|공식사이트]]를 참고한다. ===== 상품 정의 ===== 오픈 그래프의 타입인 [[https://developers.facebook.com/docs/payments/product/|og:product 오브젝트]]를 정의하는 단계이다. ==== 상품 종류 ==== 페이스북 앱에서 제공할 수 있는 상품의 종류에는 아래와 같이 두 가지가 있다. * In-app Currency (Virtual Currency) 페이스북에서 권장하는 상품 판매 모델로써, 게임에서 쓰이는 코인의 개념이다. 유저는 코인을 구입한 후 이 코인을 통해 다른 상품을 구매할 수 있다. 이 방법을 권장하는 이유는 [[https://developers.facebook.com/docs/howtos/payments/paymentflow#pricejumping|Price Jumping]] 현상을 방지하기 위해서이다.((이는 고정된 price point(기준 소매 가격)을 가지는 결제 수단으로 결제하는 경우 fee를 추가로 지불하게 되는 현상이다.)) In-app Currency를 사용하면 코인 가격 조절을 통해 Price Jumping 현상에 쉽게 대처할 수 있게끔 해준다. 1코인당 0.10달러 정도로 설정하면 된다. (소수점 아래 둘째 자리까지 조절 가능하다) og:product는 다음과 같은 형태로 정의한다.

* In-app Item 페이스북 앱 내에서 직접 돈을 주고 구매할 수 있는 상품이다. 여러 가지 상품을 묶어 할인된 가격으로 판매하는 '스타터 팩'이 그 예이다. og:product는 다음과 같은 형태로 정의한다.

페이스북 결제 시스템에는 추가로 지불한 금액을 저장한 후 나중에 다시 사용하는 기능이 없다. 즉, 결제 시에는 지정한 금액만큼 지불하여야 한다. 예외로 페이스북 기프트 카드의 경우에는 결제한 후 남은 금액을 다시 사용할 수 있다. ==== 가격 책정 ==== 가격에는 두 가지 종류가 있다. * 정적 가격 말그대로 고정된 가격이다. 정적 가격을 사용하려면 og:product 오브젝트에 가격을 명시하면 된다. 가격은 여러 통화 단위로 정할 수 있으며 정하지 않은 통화 단위에 대해서는 페이스북에서 환율에 따라 가격을 자동으로 변환해준다. * 동적 가격 상황이나 이벤트에 따라 변동 가능한 가격이다. og:product 오브젝트에 product:price:amount와 product:price:currency 메타 태그를 생략하면 된다. 동적 가격을 사용하면 Pay 다이얼로그를 열 때 앱 세팅의 Payments 페이지에 정의한 콜백 URL로 HTTP POST 요청을 보내게 된다. 그러므로 여기에 콜백 URL을 지정하지 않으면 안된다. ===== 구현 ===== ==== Scrape ==== Product를 정의한 html을 사용하기 위해서는 Facebook이 scrape하는 과정이 필요하다. 이를 위해서는 facebook의 [[https://developers.facebook.com/tools/debug|디버그 툴]]에 html의 URL을 적거나 직접 다음의 요청을 하면 된다.


GET https://graph.facebook.com/?id=OG_URL&scrape=true&method=post

OG_URL 대신 product의 URL을 적으면 된다. ==== API 사용 ==== [[https://developers.facebook.com/docs/graph-api/reference/v2.2/payment|레퍼런스]]를 참고한다. 이 중 중요한 옵션은 product, request_id 정도이다. product 옵션에는 og:product의 URL을 적으면 되는데 이 대신 ID를 적어도 된다. ===== 참고 ===== * [[https://developers.facebook.com/docs/payments/overview|페이스북 개발자 페이지]] * [[https://developers.facebook.com/docs/games/canvas/payments-tutorial|Canvas Payments Tutorial]]