RevGlance문서

Braintree

API 키 쌍으로 Braintree를 연결해 거래와 정기 청구를 읽습니다.

정기 청구 정보는 Braintree의 게이트웨이 API에만 있기 때문에, RevGlance는 Braintree 서버 SDK가 사용하는 이 API를 읽습니다.

연결

  1. Braintree Control Panel에서 Settings › API를 열고 새 API 키 쌍을 생성합니다.
  2. Merchant ID, Public key, Private key를 복사합니다. 이 키가 속한 API 사용자에게는 거래와 구독을 읽을 수 있는 역할이 필요합니다.
  3. 값을 채우고 환경에 production(샌드박스 계정이면 sandbox)을 입력한 다음 Braintree 연결을 선택합니다.

양식에서 묻는 항목

필드형식 예시
가맹점 IDabc123def456ghi7
공개 키7xh9k3b2m4n5p6q8
개인 키암호화하여 저장0123456789abcdef0123456789abcdef
환경production 또는 sandbox

Webhook 추가하기

Braintree는 소스에 이미 있는 API 키로 Webhook에 서명하므로 붙여넣을 시크릿이 없습니다.

  1. RevGlance에서 설정 › 소스를 열고 Braintree 소스의 메뉴를 연 다음 Webhook을 선택합니다. URL을 복사합니다.
  2. Braintree Control Panel에서 Settings › Webhooks를 열고 그 URL로 Webhook을 만든 다음 구독 및 거래 알림을 선택합니다.

RevGlance가 동기화하는 항목

  • 거래: 정산되었거나 정산 중인 판매는 결제가 되고, 크레딧은 환불이 됩니다. 캡처되지 않은 승인은 제외됩니다.
  • 구독과 그 플랜, 애드온, 할인: MRR, 체험판, 해지에 사용됩니다.

첫 동기화는 Braintree가 보관하는 모든 거래를 읽습니다. Braintree는 API를 통해 처리 수수료와 해지 이유를 보고하지 않습니다.

Braintree의 집계 방식

  • 정산 완료 및 정산 중인 판매가 집계되며, 세금 금액을 보내는 경우 세전입니다. 매입되지 않은 승인은 집계되지 않습니다.
  • 환불은 크레딧 거래이며, Braintree가 처리한 날짜로 기록됩니다.
  • Braintree는 API로 처리 수수료를 보고하지 않으므로 수수료는 0으로 표시됩니다.
  • MRR은 애드온을 포함한 구독 가격에서 결제 주기가 남은 할인을 뺀 금액입니다. 구독에는 고객 정보가 없으므로 결제의 고객을 사용하며, 아직 결제가 없는 구독은 카드 기준으로 표시됩니다.
  • 해지 날짜는 상태 기록에서 가져옵니다. 만료된 구독은 결제 완료 기간의 마지막 날에 종료됩니다.
  • 수금하지 못한 결제는 실패한 결제로 집계됩니다. 금액은 이동하지 않습니다.
  • 지불 거절은 읽지 않으므로, 진 지불 거절은 결제 대행사가 환불로도 보고하지 않는 한 결제로 계속 집계됩니다.