빠른 시작

통합 절차

결제 솔루션 통합 방법:

  1. 관리자 페이지에서 프로젝트를 생성합니다. 하나의 프로젝트는 하나의 게임에 해당합니다. 게임이 여러 개 있는 경우 각 게임마다 프로젝트를 추가해야 합니다.
  2. 엑솔라 측 카탈로그에 판매하려는 아이템을 추가합니다.
  3. 사용자가 결제할 주문 생성하는 테스트를 진행합니다.
  4. 구매 테스트를 진행하고 알림을 설정합니다.
  5. 실제 결제 처리를 시작하려면 관리자 페이지에서 엑솔라와 라이선스 계약을 체결합니다.

알림
모든 연동 단계에서 라이선스 계약에 서명할 수 있지만, 서명 절차에 최대 3일(영업일 기준)이 소요될 수 있다는 점에 유의해 주세요.

카탈로그 생성하기

가상 아이템은 사용자가 실제 통화 및 인게임 재화로 구매할 수 있는 인게임 콘텐츠입니다. 엑솔라 측에서 가상 아이템 카탈로그를 생성하면 지역별 가격 및 제한을 사용자 정의할 수 있을 뿐만 아니라 정기적으로 추가 및 업데이트되는 엑솔라의 프로모션 및 기타 기능 시스템을 사용할 수도 있습니다.

가상 아이템 만들기

아이템 목록 가져오기

아이템 목록을 가져오려면 가상 아이템 목록 가져오기 API 메소드를 호출합니다.

  • 요청 헤더에서 기본값으로 인증에 사용되는 엑솔라 로그인 JWT(전달자 토큰)를 전달합니다. 이 API 메소드 호출을 테스트하기 위해 다음 테스트 토큰을 사용할 수 있습니다.Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJleHAiOjE5NjIyMzQwNDgsImlzcyI6Imh0dHBzOi8vbG9naW4ueHNvbGxhLmNvbSIsImlhdCI6MTU2MjE0NzY0OCwidXNlcm5hbWUiOiJ4c29sbGEiLCJ4c29sbGFfbG9naW5fYWNjZXNzX2tleSI6IjA2SWF2ZHpDeEVHbm5aMTlpLUc5TmMxVWFfTWFZOXhTR3ZEVEY4OFE3RnMiLCJzdWIiOiJkMzQyZGFkMi05ZDU5LTExZTktYTM4NC00MjAxMGFhODAwM2YiLCJlbWFpbCI6InN1cHBvcnRAeHNvbGxhLmNvbSIsInR5cGUiOiJ4c29sbGFfbG9naW4iLCJ4c29sbGFfbG9naW5fcHJvamVjdF9pZCI6ImU2ZGZhYWM2LTc4YTgtMTFlOS05MjQ0LTQyMDEwYWE4MDAwNCIsInB1Ymxpc2hlcl9pZCI6MTU5MjR9.GCrW42OguZbLZTaoixCZgAeNLGH2xCeJHxl8u8Xn2aI.
  • project_id 경로 매개 변수에서 관리자 페이지에서 확인할 수 있는 프로젝트 ID를 전달합니다.

응답으로 프로젝트에서 생성된 가상 아이템에 대한 자세한 정보를 받게 됩니다. 이후 주문을 생성하려면 items.sku 매개 변수에서 전달된 아이템 SKU가 필요합니다.

주문 생성

주문은 사용자가 스토어에서 구매하려는 아이템으로 구성됩니다. 주문을 결제한 후 사용자는 아이템을 수령합니다. 결제하려면 사용자가 게임에서 인증 받아야 합니다.

설정 지침을 확인하려면 게임에 적합한 연동 메소드를 선택하세요.

특징서버 측클라이언트 측
서버 보유토큰을 받고 서버의 부하를 제어하려면 자체 서버가 있어야 합니다.자체 서버를 보유할 필요는 없습니다.
사용자 국가 결정결제 토큰에서 국가 또는 IP 주소를 전달해야 합니다. 이는 결제 방식의 사용 가능 여부에 영향을 줍니다.엑솔라가 IP 주소로 사용자의 국가를 결정합니다.
결제 통화 결정토큰에서 통화를 전달하지 않으면 국가에 따라 결정됩니다.
토큰에서 통화를 전달하면 사용자가 해당 통화로 결제를 진행합니다.
통화는 국가에 따라 결정됩니다.

테스트 구매하기

알림
테스트를 진행하는 동안에는 실제 은행 계좌에서 돈을 인출할 필요가 없으며, 테스트 카드 중 하나를 사용할 수 있습니다.
주의
엑솔라와 계약을 체결하기 전에는 샌드박스 모드에서만 결제 프로세스를 테스트할 수 있습니다.

샌드박스 모드에서 결제 UI 열기

새 창에서 결제 UI를 열려면 https://sandbox-secure.xsolla.com/paystation4/?token=TOKEN URL을 사용합니다. 여기서 TOKEN주문을 생성할 때 획득한 토큰입니다.

다른 방법으로 결제 UI를 열려면 문서를 참조하세요.

테스트 결제하기

  1. 샌드박스 모드로 결제 UI를 엽니다.
  2. 은행 카드 결제 방식을 선택합니다.
  3. 은행 카드 세부 정보를 입력합니다. 다른 필드(예: 이름 또는 주소)에는 아무 데이터나 입력할 수 있습니다. 오류가 생성되는지 확인하기 위해 잘못된 세부 정보(카드 번호 또는 만료일)를 입력할 수도 있습니다.
  4. 지불을 클릭합니다.
테스트 카드 목록
테스트 은행 카드 목록을 봅니다.
알림
우편번호에 대한 정보

카드 세부 정보 외에도 다음 조건 중 하나라도 충족하는 경우 우편번호를 지정해야 합니다.

  • 사용자의 국가가 미국 또는 캐나다입니다.
  • 은행 식별 번호(BIN)가 카드가 미국에서 발급되었음을 나타냅니다.

유효한 우편번호(예: 12345)를 지정할 수 있습니다. 이는 판매 세율을 결정하며 결제 테스트 진행에 영향을 주지 않습니다.
샌드박스 은행 카드 결제를 진행할 수 있는 통화: USD, EUR, RUB, GBP, AED, ALL, AMD, ARS, AUD, AZN, BGN, BRL, BYN, CAD, CHF, CLP, CNY, COP, CZK, DKK, DZD, EGP, GEL, HKD, HRK, HUF, IDR, ILS, INR, ISK, JPY, KES, KGS, KRW, KZT, MAD, MDL, MKD, MNT, MXN, MYR, NGN, PEN, PHP, PKR, PLN, RON, RSD, SAR, SEK, SGD, THB, TRY, TWD, UAH, UYU, UZS, VEF, VND, ZAR.

주의
샌드박스 모드에서는 은행 카드PayPal을 사용하여 일회성 결제 및 저장된 결제 방법으로 결제를 테스트할 수 있습니다.

웹훅 설정

서버 측에서 연동을 설정하는 경우, 웹훅에 대한 응답으로 해당 코드 전송을 통해 생성된 주문의 유효성을 검사해야 합니다. 클라이언트 측에서 연동을 설정하는 경우 웹훅을 통해 구성된 이벤트(예: 결제 상태 변경)에 대한 알림을 받을 수 있습니다.
PHP SDK
웹훅 처리용으로 준비된 클래스 사용.
엑솔라 측에서 웹훅을 설정하는 방법:
  1. 관리자 페이지에서 프로젝트를 엽니다.
  2. 사이드 메뉴에서 프로젝트 설정을 클릭하고 웹훅으로 이동합니다.
  3. 웹훅 토글을 켜짐으로 설정합니다.
  4. 웹훅 URL을 지정합니다.
  5. 프로젝트 웹훅에 서명하기 위한 비밀 키가 기본적으로 생성됩니다. 새 비밀 키를 생성하려면 새로 고침 아이콘을 클릭합니다.
  6. 설정 저장을 클릭합니다.
알림
웹훅을 테스트하기 위해 webhook.site와 같은 전용 웹 사이트를 선택할 수 있습니다.
사용자 유효성 검사 및 결제 성공에 대한 알림을 받으려면 다음 웹훅을 구성합니다.

웹훅 수신기 구성

웹훅 수신기는 지정된 URL 주소에서 들어오는 웹훅을 수신하고 서명을 생성한 후 엑솔라 웹훅 서버로 응답을 전송할 수 있는 프로그램 코드입니다.
서명 생성 및 웹훅에 대한 응답 전송에 대한 정보

서명 생성

웹훅을 수신할 때는 데이터 전송의 보안을 보장해야 합니다. 이를 위해서는 웹훅 데이터에서 서명을 생성하고 생성된 서명이 HTTP 요청 헤더에 전송된 서명과 일치하는지 확인해야 합니다. 서명 생성 방법:
  1. 요청 본문과 프로젝트의 비밀 키의 JSON을 연결합니다.
  2. 첫 번째 단계에서 구한 문자열에 SHA-1 암호화 해시 함수를 적용합니다.

웹훅으로 응답 보내기

웹훅 수신을 확인하려면 서버가 다음을 반환해야 합니다.
  • 204 성공적인 응답의 경우 메시지 본문이 없는 HTTP 코드
  • 400 지정된 사용자를 찾을 수 없거나 유효하지 않은 서명이 전달된 경우 문제에 대한 설명이 포함된 HTTP 코드
서버에 일시적인 문제가 발생한 경우 웹훅 핸들러가 5xx 코드를 반환할 수도 있습니다. 주문 결제 성공주문 취소 웹훅에 대한 응답을 받지 못했거나 5xx 코드가 포함된 응답을 받은 경우, 다음 일정에 따라 웹훅이 다시 전송됩니다.
  • 5분 간격으로 2번
  • 15분 간격으로 7번
  • 60분 간격으로 10번
웹훅 전송은 처음 시도 후 12시간 이내에 최대 20번까지 시도할 수 있습니다. 결제 웹훅에 대한 응답이 수신되지 않았거나 5xx 코드가 포함된 응답이 수신된 경우 웹훅도 증가된 시간 간격으로 재전송됩니다. 12시간 동안 최대 12번 시도할 수 있습니다. 사용자 유효성 검사 웹훅에 대한 응답이 수신되지 않았거나 400 또는 5xx 코드가 포함된 응답이 수신된 경우 사용자 유효성 검사 웹훅이 재전송되지 않습니다. 이 경우 사용자에게 오류가 표시되며 결제주문 결제 성공 웹훅은 전송되지 않습니다.

런칭

주의
라이선스 계약에 서명하기 전에는 샌드박스 모드로만 결제 UI를 열 수 있습니다.

라이선스 계약에 서명

라이선스 계약에 서명하면 엑솔라에서 지원하는 모든 결제 방식을 통해 실제 결제를 받을 수 있습니다. 라이선스 계약에 서명하는 방법:

  1. 관리자 페이지을 엽니다.
  2. 사이드 메뉴에서 계약 및 세금 > 계약 섹션으로 이동합니다.
  3. 라이선싱 계약 탭으로 이동한 후 신청서 작성을 클릭합니다.
  4. 해당 필드에 정보를 입력합니다.

신청서 검토에는 영업일 기준 3일 정도 걸립니다. 검증 절차를 진행하는 동안 질문이 있는 경우 엑솔라는 신청서에 표시된 담당자에게 연락합니다. 엑솔라 측의 확인 절차가 완료되면 계약 상태가 서명됨으로 변경됩니다.

프로덕션 환경으로 전환하기

주의
실제 첫 지불 이후, 엄격한 샌드박스 지불 정책이 적용됩니다. 샌드박스 모드에서의 지불은 회사 설정 > 사용자 섹션의 관리자 페이지에서 지정된 사용자에 한해서만 가능합니다.
이전 단계를 완료하면 실제로 결제하도록 설정할 수 있습니다.
  1. 엑솔라와의 라이선스 계약에 서명했는지 확인합니다.
  2. 토큰을 입수할 때 요청 본문에서 “sandbox”: true 매개변수를 제거합니다.
  3. https://secure.xsolla.com/paystation4/?token=TOKEN 링크를 사용하여 결제 UI를 엽니다.
알림
본 가이드는 연동을 빠르게 시작하는 데 필요한 최소 설정을 설명합니다. 질문이 있을 경우 페이지 오른쪽 하단의 엑솔라 채팅을 통해 문의하거나 고객 성공 매니저에게 csm@xsolla.com으로 이메일을 보내주세요.
이 기사가 도움이 되었나요?
감사합니다!
개선해야 할 점이 있을까요? 메시지
유감입니다
이 기사가 도움이 안 된 이유를 설명해 주세요. 메시지
의견을 보내 주셔서 감사드립니다!
메시지를 검토한 후 사용자 경험 향상에 사용하겠습니다.
이 페이지 평가
이 페이지 평가
개선해야 할 점이 있을까요?

답하기 원하지 않습니다

의견을 보내 주셔서 감사드립니다!
마지막 업데이트: 2024년 2월 9일

오자 또는 기타 텍스트 오류를 찾으셨나요? 텍스트를 선택하고 컨트롤+엔터를 누르세요.

문제 보고
콘텐츠를 항상 검토합니다. 여러분의 피드백은 콘텐츠를 개선에 도움이 됩니다.
후속 조치를 위해 이메일을 제공해 주세요
의견을 보내 주셔서 감사드립니다!