FAQ

여기에서 원하는 답변을 찾지 못하는 경우 다음 채널 중 하나를 통해 도와드리겠습니다.

통합

Q. iframe에서 페이 스테이션을 열려면 어떻게 해야 하나요?

A. Pay Station Embed 스크립트를 사용하여 라이트박스에서 페이 스테이션을 실행하는 것이 좋습니다. 이 스크립트에는 다음과 같은 기능이 있습니다.

  • 페이 스테이션 크기 및 장치 유형(데스크톱 vs 모바일)을 자동으로 결정
  • 결제 UI에서 자동으로 이벤트 수신
  • UI 테마 변경 허용

그래도 iframe 내부에서 결제 UI를 열기 원한다면 다음을 수행해야 합니다.

  • 장치 유형(데스크톱 vs 모바일)을 지정하고 토큰 settings.ui.version 매개변수 내에서 전송
  • 결제 UI에서 이벤트를 수신하는 postMessage 메커니즘 구현
  • 토큰 가져오기
  • 토큰에서 페이 스테이션 창 크기 전송:

페이 스테이션 크기Iframe 너비
대(기본값)670–850px
중590–740px
소510–630px

Iframe에서 페이 스테이션 UI를 열려면 다음 링크를 사용합니다. 링크: https://secure.xsolla.com/paystation2/?access_token=ACCESS_TOKEN. ACCESS_TOKEN 이 결제 UI 토큰으로 지정되어 있는 링크입니다.

Q. 페이 스테이션 UI와 게시자 계정에서 지원하는 브라우저는 무엇인가요?

A. 페이 스테이션 UI와 게시자 계정은 다음 브라우저에서 올바르게 작동합니다.

  • Google Chrome 49 이상
  • Mozilla Firefox 45 이상
  • Opera 36 이상
  • Internet Explorer 11
  • Microsoft Edge 12 이상
  • Safari 9 이상
  • Android Browser 49 이상

Q. 화이트리스트(허용 목록)에 등록해야 하는 엑솔라 Network IP 주소는 무엇인가요?

A. 다음 IP 주소에서 웹훅을 수락하고 처리할 수 있어야 합니다. 185.30.20.0/24, 185.30.21.0/24.

Q. 엑솔라 Network/ 스토어 / 로그인이나 기타 신제품 또는 엑솔라 보조 제품을 통합하려면 어떻게 해야 하나요?

A. 엑솔라 제품을 통합하려면 integration@xsolla.com으로 문의해 주시면 관련 도움을 드리겠습니다.

Q. 결제 방식에 paysafecard를 추가하려면 어떻게 해야 하나요?

A. 새 결제 방식을 추가하려면 integration@xsolla.com으로 문의하십시오.

Q. Node.JS/C#.NET/Ruby/Java/ASP 등을 위한 SDK가 있나요?

A. 현재 PHP와 Android용 SDK를 보유하고 있습니다. HTTPS 요청 기능이 있다면 특정 언어/플랫폼을 사용하여 자체 SDK를 만들 수 있습니다.

Q. 내 사이트에서 PHP 라이브러리가 작동하지 않는 이유는 무엇인가요?

A. 필수 파일이 모두 설치되어 있고 관련 경로가 유효한지 확인합니다. GitHub에서 설정에 대한 자세한 정보를 확인할 수 있습니다.

게임유저 유효성 검사

Q. 유저 ID란 무엇인가요? 유저는 어떻게 확인하나요?

A. user ID는 게임에서 유저를 식별하는 방식입니다. 데이터베이스를 사용하여 유저 ID를 저장할 수 있습니다. 유효하지 않은 user ID를 사용하면 예외로 처리됩니다. 유저 확인 예제는 GitHub에서 확인할 수 있습니다.

Q. 확인 절차가 완료되면 어떠한 데이터가 반환되나요? 예를 들어, 유저 확인이 성공적으로 이루어지거나 실패할 경우 반환되는 내용은 무엇인가요?

A. 유저 확인이 성공적으로 이루어지면 200 응답을 보내야 합니다. 유저 확인에 실패하면, 오류 코드 INVALID_USER와 함께 400 응답을 보내야 합니다.

프로젝트 설정

Q. 게시자 계정에서 활성화한 모듈은 어떻게 실행하나요?

A. 모듈을 실행하기 전에 모듈을 구성하고 테스트해야 합니다. 자세한 내용은 통합 가이드를 참조하십시오. 웹훅 수신에 문제가 있는 경우, 웹훅 서버가 올바르게 설치되어 있는지 확인하십시오. 문제가 지속되면 integration@xsolla.com으로 문의하십시오.

Q. QA, 준비, 제작 등 각 환경에서 사용할 새 프로젝트 ID를 생성해야 하나요?

A. 제작 환경 프로젝트가 영향을 받지 않도록 별도의 프로젝트를 사용하는 것이 좋습니다.

Q. 시크릿 키, 프로젝트 키, API 키의 차이점은 무엇인가요?

A. 시크릿 키와 프로젝트 키는 동일한 키입니다. 시크릿 키는 안전 결제에 필요한 디지털 서명에 사용됩니다. 요청 JSON 본문을 프로젝트 시크릿 키와 연결하고 결과 문자열에 SHA-1 해시를 적용합니다. API key는 엑솔라 서버로 전송된 API 호출에 사용됩니다. API 키는 게임 바이너리나 프론트 엔드 내부에 있는 자체 서버에 보관해야 합니다.

Q. 웹훅 URL과 복귀 URL의 차이점은 무엇인가요?

A. 웹훅 URL은 웹훅 서버의 URL입니다. 복귀 URL은 결제 완료 후 유저가 리디렉션되는 URL입니다.

Q. 프로젝트 ID/판매자 ID/게시자 ID는 어디에서 확인하나요?

A. 프로젝트 ID는 게시자 계정의 프로젝트 이름 옆에 있는 숫자입니다. 또한, 다음 URL에서 확인할 수 있는 번호이기도 합니다. URL: https://publisher.xsolla.com/{merchant_id}/projects/{project_id}/ 판매자 ID와 게시자 ID는 사실상 동일한 ID입니다. 다음 URL에서 ID 번호를 확인할 수 있습니다. URL: https://publisher.xsolla.com/{merchant_id}/.

Q. API 키는 어디에서 확인할 수 있나요?

A. API 키를 생성하려면, 게시자 계정에서 회사 설정 > API 키로 이동합니다.

Q. 회사 직원이 내 게시자 계정에 액세스하도록 초대하려면 어떻게 해야 하나요?

A. 게시자 계정에서 회사 설정 > 유저로 이동하여 직원을 추가하고 초대할 수 있습니다.

Q. 저는 모바일 게임 게시자입니다. 프로젝트 설정 페이지에서 웹사이트 필드에 무엇을 입력해야 하나요?

A. 게입 웹사이트 URL이나 회사 웹사이트 URL을 입력하면 됩니다.

Buycraft 프로젝트 설정

Q. Buycraft 프로젝트 ID/판매자 ID/API 키/시크릿 키 매개변수는 어디에서 확인할 수 있나요?

A. 이 가이드를 사용하여 이러한 매개변수를 확인하고 프로젝트를 설정할 수 있습니다.

Q. Buycraft 설정에서 계약 정보 섹션에 게임 제목으로 무엇을 입력해야 하나요?

A. 서버 이름을 입력하면 됩니다.

웹훅 설정

Q. 웹훅 프로토콜로 HTTPS를 사용하나요?

A. 예, 엑솔라 API는 기본 액세스 인증을 사용합니다 때문에 https를 사용해야 합니다.

Q. 웹훅 URL이 알림을 받지 못하는 이유는 무엇인가요?

A. 필수 파일이 모두 있고 웹훅 서버에서 필요한 유형의 웹훅 요청을 처리하도록 설정되어 있는지 확인합니다.

Q. 웹훅에서 제 모바일 앱으로 전송하도록 설정할 수 없나요?

A. 웹훅은 프로젝트 설정에서 정의한 단일 URL 끝점으로만 전송됩니다. 따라서, 웹훅은 서버 간(server-to-server) 전송만 가능하며, 다양한 URL로 전송되지 않습니다. 게임, 웹사이트 또는 모바일 앱에서 알림을 사용하려면, 엑솔라와 게임 사이에서 데이터를 전달하는 메시지 솔루션을 자체 서버에 구축하는 것이 좋습니다.

사용자 정의

Q. 페이 스테이션 테마를 사용자 정의할 수 있나요?

A. 토큰에서 settings.ui.theme = default_dark(어둡게) 를 전송하여 어두운 테마를 선택할 수 있습니다. 어두운 테마를 사용하면 배경을 선택한 이미지나 색상으로 설정할 수도 있습니다(예제 참조). 다른 설정을 변경하려면 계정 관리자에게 문의하십시오.

Q. 사용자에게 전송하는 메시지 표시 형식을 변경할 수 있나요?

A. 이메일 테마를 사용자 정의하려면 계정 관리자에게 문의하십시오. 이메일 요소 레이아웃은 표준 템플릿이기에 변경할 수 없습니다. 이러한 조치는 법적으로 기록상 판매자 역할을 하는 엑솔라와의 라이선스 계약에 따라 지켜져야 합니다.

테스트

Q. 결제 테스트에 이용할 수 있는 연습용 신용/직불 카드가 있나요?

A. 예, 샌드박스 모드에서 테스트 카드를 사용해볼 수 있습니다.

Q. 샌드박스 모드에서 PayPal도 테스트해볼 수 있나요?

A. 안타깝게도 PayPal 결제는 현재 샌드박스 모드로 테스트해볼 수 없습니다.

Q. 환불 절차를 연습해보려면 어떻게 해야 하나요?

A. 게시자 계정에서 환불 웹훅을 사용하거나 지원 > 거래 검색으로 이동할 수 있습니다.

Q. 엑솔라 인보이스 ID 및 내 프로젝트의 테스트 탭에서 인보이스 ID는 무엇인가요?

A. 엑솔라 ID가 엑솔라에서 트랜잭션 ID로 사용됩니다. 인보이스 ID는 게임에서 선택적으로 사용하는 트랜잭션 ID입니다. 테스트하는 경우, 임의의 숫자를 입력하여 사용할 수 있습니다.

Q. Buycraft 프로젝트 테스트를 통과할 수 없는데, 이유가 뭔가요?

A. Buycraft 파트너는 Buycraft 계정에 API 키, 판매자 ID, 프로젝트 ID 또는 시크릿 키가 올바르게 입력되지 않은 경우 INVALID_SIGNATURE를 받게 됩니다.

결제

Q. 웹훅에서 받은 결제 요청을 확인하려면 어떻게 해야 하나요?

A. 유저 ID를 확인하여 프로젝트에 결제 요청이 있는지 확인하고 코드 200을 반환하여 결제를 인증합니다.

Q. 최근에 사용한 결제 계정은 어떻게 확인할 수 있나요?

A. 현재는 해당 기능을 제공하고 있지 않습니다.

Q. 유저를 특정 결제 방식으로 즉시 리디렉션할 수 있나요?

A. 예, 스토어 UI를 실행할 때 settings.payment_method 매개변수를 전송하면 됩니다. 그러면, 유저는 선택한 결제 방식에 해당하는 결제 양식으로 즉시 리디렉션됩니다. 게시자 계정의 결제 방식 섹션이나 결제 시스템 메소드 가져오기를 사용하여 결제 방식 ID 목록을 확인할 수 있습니다.

Q. 결제를 처리한 후 결과에 따라 자동으로 유저를 성공/실패 결제 페이지로 리디렉션할 수 있나요?

A. 예, 게시자 계정에서 페이 스테이션 설정으로 이동하여 리디렉션 정책을 설정할 수 있습니다.

Q. 당사 결제 시스템은 각 주문에 대해 order_id를 자동으로 설정합니다. 토큰을 수신할 때 user_id 대신 order_id를 사용할 수 있나요?

A. external_id 매개변수에서 order_id 값을 전송할 수 있습니다. 매개변수를 활성화하려면, 페이 스테이션 설정으로 이동한 후 External ID를 켜기로 설정합니다.

Q. 모든 트랜잭션마다 결제 스크립트 URL을 재정의할 수 있나요?

A. 아니요, 전체 트랜잭션에 해당하는 결제 스크립트 URL은 게시자 계정에서 설정할 수 있습니다.

Q. 실패한 트랜잭션의 세부 정보를 보내주나요?

A. 아니요, 트랜잭션에 성공한 경우에만 웹훅을 전송합니다. 웹훅을 받았다면 트랜잭션이 성공적으로 이루어진 것입니다.

Q. 총 결제 금액에 VAT 소비세는 어떻게 추가하나요?

A. VAT설정은 엑솔라에서 구성합니다. 기본 구성을 사용하여 직접 지급하는 대신 VAT를 포함한 금액으로 고객에게 청구하려면 계정 관리자에게 문의하여 설정을 변경합니다.

Q. PID란 무엇인가요?

A. PID는 엑솔라에서 사용하는 결제 시스템 식별자입니다.

Q. 사용자의 가상 통화 잔액을 업데이트하려면 어떻게 해야 하나요?

A. 잔액 업데이트 API 방식을 사용할 수 있습니다.

Q. External ID와 게임/플랫폼에서 사용하는 고객 ID가 같은 건가요? 트랜잭션별로 External ID를 새로 만들어야 하나요?

A. External ID는 시스템에 있는 인보이스 ID입니다. 제공하는 external_id로 한 번만 결제할 수 있으므로 유저가 결제할 때마다 새 External ID를 전송해야 합니다.

Q. setExternalPaymentId 방식으로 어떠한 값을 설정해야 하나요?

A. 보유한 값이 있다면 external_id 값을 설정합니다.

Q. PHP SDK로 purchase.description.value를 설정하려면 어떻게 해야 하나요?

A. 구매 설명은 페이 스테이션 UI와 이메일 영수증에 사용됩니다. 해당 값은 토큰에서 설정할 수 있습니다.

Q. 게이트웨이란 무엇인가요?

A. 게이트웨이를 사용하면 페이 스테이션 인터페이스에서 이용할 수 있는 결제 시스템으로부터 직접 결제금을 받을 수 있습니다. 이러한 상호작용 모델에서 플레이어와 관련된 변경 사항은 없습니다. 선택한 결제 방식으로 모든 구매가 진행됩니다. 다시 말해 원하는 결제 시스템이나 결제 대행사를 연결하고 결제 시스템 제공업체로부터 직접 결제금을 받을 수 있습니다.

엑솔라는 기술 서비스 제공자의 역할만을 수행하며 한정적인 매출 수수료(1.25% + $0.10) 취합니다. 이는 파트너가 아래에 나열된 기능을 제외한 모든 엑솔라 솔루션을 받게 됨을 의미합니다.

  • 파트너는 각 결제 시스템과 별도의 계약을 체결합니다.
  • 파트너는 결제 시스템에서 직접 자금 흐름을 갖게 됩니다.
  • 파트너는 결제 시스템 관리 비용, 지급 수수료, 운영 비용을 책임집니다.

예를 들어 PayPal을 직접 결제 방식으로 설정하려면 다이렉트 계좌가 필요합니다. 이러한 모델을 사용해도 인터페이스는 변하지 않지만 중요한 변경 사항이 있습니다. 결제가 처리된 후 최종 사용자의 돈은 여러분의 PayPal 계정으로 바로 입금됩니다. 이러한 방식에서 엑솔라는 개입되지 않습니다.

Q. Buycraft 프로젝트에서 사용하는 결제 방식은 무엇인가요?

A. Buycraft 프로젝트 결제 방식으로 Paypal과 은행 송금을 지원합니다.

Q. 엑솔라에 사용자 데이터(저장한 결제 계정, 구독 등)를 어떻게 마이그레이션할 수 있습니까?

A. 사용자 데이터를 마이그레이션하려면 계정 관리자에게 문의하십시오. PGP 암호화를 사용하여 보안 기능을 제공하십시오.

쿠폰

Q. 독립 실행형 쿠폰과 프로모션에 사용하는 쿠폰의 차이점은 무엇인가요?

A. 독립 실행형 쿠폰은 쿠폰 코드를 사용하여 무료 아이템으로 교환하는 경우에 사용할 수 있습니다. 쿠폰 코드로 구매하는 경우 프로모션 기능을 사용하면, 할인된 가격으로 구매하거나 보너스를 받게 됩니다.

정기 결제

Q. 구독에 있는 product_id는 무엇인가요?

A. 이 매개변수는 유저가 여러 유료 구독 서비스를 이용하는 경우에 사용할 수 있습니다. product_id는 유저가 이용하는 구독 서비스를 구분할 때 사용합니다.

오류 메시지

Q. 페이 스테이션 UI를 실행하면 오류 코드: 0004-0008이 보입니다. 무슨 뜻인가요?

A. 샌드박스 모드에서 잘못된 URL을 사용하고 있습니다. 실제로 결제 기능을 사용하려면 secure.xsolla.com 을 사용합니다. 시험 결제 기능을 사용하려면 sandbox-secure.xsolla.com 을 사용합니다. 발생 가능한 오류에 대한 자세한 정보는 API 참조에서 확인할 수 있습니다.

Q. 엑솔라 PHP SDK가 INVALID_CLIENT_IP 오류를 반환합니다. 무엇을 해야 하나요?

A. 리버스 프록시 IP 주소를 웹훅 서버에 추가해야 합니다.

Q. 2205 또는 2207 오류(유저 ID 오류)는 무엇을 의미하나요?

A. 이러한 오류는 유효한 ID가 필요하다는 것을 의미합니다. 데이터베이스에서 유저 ID를 사용하고 있는지 확인합니다.

Q. 1000-0003 오류는 무엇을 의미하나요?

A. 프로젝트 모듈을 활성화해야 합니다. 또는, 체크아웃에서 구매 매개변수가 누락된 경우 이러한 오류가 발생할 수 있습니다.

Q. 0002-0004 오류는 무엇을 의미하나요?

A. 해당 오류는 결제 대금을 받으려면 당사와의 계약서에 서명해야 한다는 것을 의미합니다. 계정 관리자에게 문의하거나 onboarding@xsolla.com으로 도움을 요청합니다.

Q. 웹훅 요청에서 인증 헤더를 찾을 수 없는 이유가 무엇인가요?

A. .htaccess 나 httpd.conf Apache 파일을 편집해야 합니다. 자세한 정보는 엑솔라의 SDK Documentation를 참조하십시오.

Q. SSL 문제 때문에 토큰 문자열을 가져올 수 없는 것 같습니다. SSL을 확인하려면 귀사의 인터페이스를 필수로 사용해야 하나요?

A. 기본적으로 당사는 SSL 인증서 확인 기능을 활성화하고 운영 체제에서 제공하는 기본 CA 번들을 사용합니다. SSL 문제를 해결하는 방법에 대한 자세한 내용은 엑솔라의 SDK Documentation에서 확인할 수 있습니다.