홈
XtreamUIPro

튜토리얼

커넥터로 쇼핑몰 연결

청구 또는 쇼핑몰 플랫폼이 스스로 라인을 생성하고 갱신하게 합니다. API 키, 플랫폼용 커넥터, 테스트 주문, 그리고 이후에 일어나는 일을 알려주는 웹훅.

마지막에는 내 플랫폼에서 결제된 주문이 라인을 생성하고 결제할 때마다 갱신되며, 대시보드는 필요 없습니다. 크레딧과 판매할 수 있는 패키지를 가진 파트너(리셀러) 계정, 그리고 커넥터가 있는 플랫폼이 필요합니다. WHMCS, Blesta, WISECP, HostBill, ClientExec, FOSSBilling, Paymenter, WooCommerce 또는 Easy Digital Downloads를 쓰는 WordPress, Odoo, PrestaShop, OpenCart, Magento, Dolibarr, ERPNext, 그리고 웹훅 브리지를 통한 Shopify, Upmind, Invoice Ninja를 지원합니다.

API 키 만들기

파트너 계정으로 로그인해 API Key를 엽니다. 키는 만들 때 한 번만 표시되므로 바로 복사하세요. 시스템마다 이름과 사용을 허용할 주소를 붙인 추가 키를 만들면 다른 키에 영향을 주지 않고 하나만 취소할 수 있습니다. 커넥터에는 쓰기가 가능한 키가 필요하므로 읽기 전용 플래그는 끈 채로 두세요.

파트너 계정의 API Key 페이지: 키, 시스템별 추가 키, 웹훅, 최근 호출.
파트너 계정의 API Key 페이지: 키, 시스템별 추가 키, 웹훅, 최근 호출.

커넥터 고르기

Resources → All Connectors를 열고 사용하는 플랫폼을 선택합니다. 해당 페이지에는 연결 정보, 설치 단계, Download 버튼, 검증용 파일의 SHA-256, 그 커넥터가 어디까지 테스트되었는지(실제 플랫폼 안에서 실행한 것도 있고 핵심 부분만 실행한 것도 있습니다)가 나와 있습니다. 소스는 공개되어 있고 같은 파일이 커넥터 사이트에도 게시됩니다.

All Connectors 페이지: 플랫폼마다 카드 하나로 버전과 테스트 범위를 표시.
All Connectors 페이지: 플랫폼마다 카드 하나로 버전과 테스트 범위를 표시.

플랫폼에 설치

체크섬을 확인하고 커넥터 페이지에 나온 위치에 파일을 설치합니다. WHMCS, Blesta, FOSSBilling은 모듈 폴더, WordPress는 플러그인 업로드, Odoo는 addons 폴더, OpenCart는 확장 설치 프로그램 등입니다. Shopify, Upmind, Invoice Ninja용 웹훅 브리지는 직접 호스팅하는 작은 PHP 애플리케이션입니다. 커넥터는 내 키로 Reseller API를 호출할 뿐이며, 내 계정이 할 수 있는 일 이상은 할 수 없습니다.

WHMCS 커넥터의 페이지: 연결 정보, 설치 단계, 다운로드와 그 SHA-256.
WHMCS 커넥터의 페이지: 연결 정보, 설치 단계, 다운로드와 그 SHA-256.

설정하기

커넥터 설정에 API 서버의 주소(/reseller/v1 경로)와 키를 입력하고, 플랫폼의 각 상품을 내 그룹이 판매할 수 있는 패키지에 대응시킵니다. 가격과 결제는 내 플랫폼에 남습니다. 패널은 돈을 받지 않으며 결제 게이트웨이도 없습니다.

테스트 주문하기

플랫폼의 테스트 환경에서 상품을 주문합니다. 커넥터가 패키지와 요청 ID로 create_line을 호출하고, Lines에 패키지의 기간을 만료일로 하는 라인이 나타나며, 플랫폼이 그 자격 증명을 받습니다. 갱신은 자체 요청 ID로 renew_line을 호출하므로 네트워크 오류 후 재시도해도 이중으로 청구되지 않습니다. API Key 페이지에는 최근 호출이 동작, 결과, 오류 코드, 주소, 커넥터 이름과 함께 표시됩니다.

테스트 주문 후의 Lines 페이지: 커넥터가 요청한 패키지, 만료일, 연결 수를 가진 새 라인.
테스트 주문 후의 Lines 페이지: 커넥터가 요청한 패키지, 만료일, 연결 수를 가진 새 라인.

웹훅 추가(선택)

API Key 페이지에서 원하는 이벤트(line.created, line.renewed, line.enabled, line.disabled, line.deleted, line.expiring, line.expired, credits.low)에 대한 웹훅 엔드포인트(내 플랫폼의 https 주소)를 추가합니다. 모든 알림은 만들 때 한 번만 표시되는 비밀 값으로 서명되며(X-Xtream-Signature) 비밀번호는 절대 포함하지 않습니다. Test 버튼으로 바로 하나를 보낼 수 있습니다.

관련 도움말

다음 튜토리얼