FAQ

통합

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

페이 스테이션 임베드 스크립트를 사용하여 라이트박스에서 결제 UI를 여는 것이 좋습니다. 이 스크립트를 사용하면 다음을 수행할 수 있습니다.

  • 자동으로 결제 UI 크기 및 장치 유형 결정(데스크톱, 모바일)
  • 결제 UI로부터 자동으로 이벤트 수신
  • UI 테마 변경

Iframe에서 결제 UI를 여는 방법:

  1. 결제 UI로부터 이벤트를 수신하기 위해 postMessage 메커니즘을 구현합니다.
  2. 토큰을 가져옵니다.

  1. 다음 링크 https://secure.xsolla.com/paystation4/?token=TOKEN로 결제 UI를 엽니다. 여기서 TOKEN은 수신한 토큰입니다.

웹훅을 구성하려면 어떤 엑솔라 네트워크 IP 주소를 허용 목록에 추가해야 하나요?

다음 IP 주소로부터 웹훅을 수신하고 처리해야 합니다.

  • 185.30.20.0/24
  • 185.30.21.0/24
  • 185.30.23.0/24

로그인 제품을 통합한 경우 35.236.32.131 IP 주소로부터의 웹훅 처리를 부가적으로 추가합니다.

Node.JS/C#/Ruby/Java/ASP 등에 사용할 수 있는 SDK가 있나요?

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

사용자 유효성 검사

사용자 ID란 무엇인가요?

사용자 ID는 게임에서 사용자 식별에 사용할 수 있는 매개변수입니다. 데이터베이스에 사용자 ID를 저장할 수 있습니다. 유효하지 않은 사용자 ID를 수신하면 예외가 발생합니다. 사용자 유효성 검사의 예시는 GitHub 저장소를 참조합니다.

유효성 검사를 완료한 후 어떤 데이터를 반환해야 하나요?

유효성 검사가 성공적인 경우 HTTP-코드 200을 반환합니다. 오류가 발생하면 코드 400(INVALID_USER)을 반환합니다.

프로젝트 설정

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

테스트의 경우 제작 환경에 영향을 미치지 않도록 별도의 프로젝트를 사용하는 것이 좋습니다.

비밀 키, 프로젝트 키, API 키의 차이점은 무엇인가요?

비밀 키는 프로젝트 키와 같습니다. 비밀 키는 안전 결제를 처리할 때 필요한 전자 서명에 사용됩니다. 요청의 JSON 본문은 이 키와 연결되어 있으며 결과는 SHA-1로 해시됩니다.

API 키는 엑솔라 서버로 전송되는 API 호출에 사용됩니다. 이 키는 자체 서버에 보관해야 하며 바이너리 파일이나 프론트엔드에 보관하면 안 됩니다. API 키 작업에 대한 자세한 정보는 API 참조를 참조하세요.

웹훅 URL과 반환 URL의 차이점은 무엇인가요?

웹훅 URL은 알림이 전송되는 웹훅 서버의 URL 주소입니다. 반환 URL은 사용자가 결제를 완료한 후 리디렉션되는 URL 주소입니다.

프로젝트 ID는 어디에서 확인할 수 있나요?

관리자 페이지에서 프로젝트를 연 후 프로젝트 설정 > 일반 설정 섹션으로 이동합니다.

판매자 ID는 어디에서 확인할 수 있나요?

관리자 페이지을 열고 회사 설정 > 회사 섹션으로 이동합니다.

알림
판매자 ID는 게시자 ID와 같습니다.

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

API 키는 생성할 때 한 번만 관리자 페이지에 표시되며 따로 저장하고 관리해야 합니다. 다음 섹션에서 키를 생성할 수 있습니다.

  • 회사 설정 > API 키
  • 프로젝트 설정 > API 키

주의

API 키 작업에 대한 자세한 정보는 API 참조를 확인하세요.

주요 권장 사항:

  • 본인의 공간에 생성된 API 키를 저장합니다.. 생성된 API 키는 관리자 페이지에서 한 번만 볼 수 있습니다.
  • API 키를 비밀로 유지해야 합니다. 이러한 API 키는 개인 계정과 관리자 페이지의 프로젝트에 대한 액세스를 제공합니다.
  • API 키는 서버에 저장해야 하며 바이너리나 프론트엔드에는 저장해선 안 됩니다.

웹훅 설정

웹훅 프로토콜로 HTTPS를 사용해야 하나요?

예.

엑솔라 알림이 웹훅 URL로 전송되지 않은 이유는 무엇인가요?

웹훅 서버에서 필수 유형의 HTTP 요청(POST, GET)을 지원하는지 확인해야 합니다.

웹훅이 내 모바일 애플리케이션으로 전송되지 않는 이유는 무엇인가요?

웹훅은 프로젝트 설정에서 지정한 단일 URL 주소로만 전송됩니다. 서버 간 전송(server-to-server)만 지원하기 때문에 웹훅에서 여러 URL 주소로 보낼 수 없습니다. 게임, 웹사이트 또는 모바일 애플리케이션에서 알림을 수신하려면 서버에서 웹훅 전송을 설정한 후 엑솔라와 게임 사이에 데이터를 전달해야 합니다.

사용자 정의

결제 UI 테마를 사용자 정의할 수 있나요?

토큰에서 settings.ui.theme = default_dark 매개변수를 전송하여 다크 테마를 활성화할 수 있습니다. 다크 테마를 사용하여 배경 이미지를 설정하거나 배경 색상을 변경할 수 있습니다(데모 참조). 다른 설정을 변경하려면 고객 성공 매니저에게 문의하거나 csm@xsolla.com으로 이메일을 보내주세요.

사용자에게 전송하는 이메일의 표시 형식을 변경할 수 있나요?

예. 사용자에게 보내는 이메일 맞춤 설정 방법 지침을 따릅니다. 이메일 구성 요소의 순서는 표준 템플릿 일부이기에 변경할 수 없습니다. 이는 기록상 법적 판매자인 엑솔라와의 라이선싱 계약에 따라 이는 요구되는 사항입니다.

테스트

테스트 카드를 사용하여 결제 프로세스를 테스트할 수 있나요?

예. 다만 샌드박스 모드로 애플리케이션 혹은 페이 스테이션 데모를 실행하는 경우에만 가능합니다. 다른 브랜드 및 발급 국가의 테스트 카드의 일반 목록을 참조합니다.

샌드박스 모드로 PayPal 결제를 테스트해볼 수 있나요?

예. 지침에서 자세한 정보를 참조해주세요.

결제 환불을 테스트하려면 어떻게 해야 하나요?

환불 요청 API 호출을 통해 환불을 테스트할 수 있습니다. 자세한 내용은 지침을 참조합니다.

관리자 페이지의 엑솔라 인보이스 ID 및 웹훅 테스트 탭의 인보이스 ID는 무엇인가요?

엑솔라 인보이스 ID는 엑솔라의 거래 ID입니다. 테스트를 수행하는 경우 임의의 숫자를 입력하여 사용할 수 있습니다.

인보이스 ID는 게임의 선택적 거래 ID입니다. 테스트를 수행하는 경우 문자와 숫자를 조합하여 입력할 수 있습니다.

페이먼트 솔루션

웹훅에서 받은 결제 요청을 확인할 수 있으려면 어떻게 해야 하나요?

먼저, 지정한 사용자 ID가 프로젝트에 있는지 확인합니다. 그런 다음 200 코드를 반환하여 결제의 유효성을 확인합니다.

사용자를 특정 결제 방법으로 리디렉션할 수 있나요?

스토어 UI를 열 때 settings.payment_method 매개변수에서 결제 방법 ID를 전달할 수 있습니다. 이 경우 사용자는 선택한 결제 방법의 결제 양식으로 리디렉션됩니다. 페이 스테이션 > 결제 방법 섹션의 관리자 페이지이나 결제 방법 가져오기 API 메소드를 호출하여 결제 방법 ID 목록을 확인할 수 있습니다.

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

예, 리디렉션 조건을 구성할 수 있습니다. 자세한 내용은 지침을 참조합니다.

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

아니요, 모든 작업을 올바르게 수행하려면 user_id가 필요합니다.

부가적으로 external_id 매개변수에서 order_id를 전달할 수 있습니다. 수행 방법:

  1. 관리자 페이지을 엽니다.
  2. 페이 스테이션 > 설정 섹션을 엽니다.
  3. 추가 설정 블록에서 거래 외부 ID 토글을 켜기로 설정합니다.

각 거래별로 웹훅 URL을 재정의할 수 있나요?

아니요. 모든 거래의 웹훅 URL은 관리자 페이지의 프로젝트 설정에서 설정할 수 있습니다.

실패한 거래의 세부 정보를 받게 되나요?

아니요. 엑솔라는 거래에 성공한 경우에만 웹훅을 전송합니다. 결제 알림을 받았다면 거래가 성공적으로 이루어진 것입니다.

총 결제 금액에 VAT를 추가할 수 있으려면 어떻게 해야 하나요?

VAT 설정은 기본적으로 엑솔라에서 구성합니다. 설정을 변경하고 사용자의 총 결제 금액에 VAT를 추가하려면 고객 성공 매니저에게 문의하거나 csm@xsolla.com으로 이메일을 보내주세요.

PID는 무엇의 약자인가요?

PID는 엑솔라에서 사용하는 결제 방법 식별자입니다.

외부 ID란 무엇인가요?

외부 ID는 시스템의 주문에 할당된 게임의 트랜잭션의 ID입니다. 엑솔라 측에서 외부 ID는 트랜잭션 ID에 연결됩니다. 그렇기 때문에 외부 ID를 활성화하면 엑솔라에서 동일한 거래에 대한 반복 결제를 방지할 수 있습니다. 외부 ID는 각 사용자 결제에 대해 고유해야 합니다.

프로젝트에서 외부 ID를 활성화하는 방법:

  1. 관리자 페이지에서 프로젝트를 연 후 페이 스테이션 > 설정 섹션으로 이동합니다.
  2. 트랜잭션 외부 ID 입니다 토글을 온으로 설정합니다.

각 거래별로 새로운 외부 ID를 생성해야 하나요?

예. 외부 ID는 각 결제별로 고유해야 합니다.

setExternalPaymentId 메소드에 대해 어떠한 값을 설정해야 하나요?

보유하고 있는 경우 setExternalPaymentId 메소드는 external_id의 값과 같게 설정해야 합니다.

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

결제 시스템과의 계약을 체결하면 게이트웨이를 사용하여 결제 UI에 이러한 결제 옵션을 표시할 수 있습니다. 플레이어는 여전히 선택한 결제 방법을 사용하여 구매 대금을 지불할 수 있으며 해당 결제 시스템 제공업체로부터 판매 대금을 직접 받게 됩니다. 게이트웨이를 연결하려면 관리자 페이지에서 프로젝트를 연 후 페이 스테이션 > 게이트웨이 섹션으로 이동합니다.

엑솔라는 기술 서비스 제공자의 역할만 수행하며 한정적인 매출 수수료(거래 금액의 1.25% +$0.10)를 받습니다. 여러분은 모든 엑솔라 솔루션에 대한 전체 액세스 권한을 갖지만 다음 사항은 직접 수행해야 합니다.

  • 세금 관련 문제 관리
  • 각 결제 시스템과 별도의 계약 체결
  • 지불 시스템으로부터 직접적인 자금 흐름을 보유
  • 결제 시스템 수수료, 지불 거절 및 환불, 지불 수수료 및 운영 비용 관리

예를 들어 PayPal을 직접 결제 수단으로 설정하려는 경우 여러분은 게이트웨이를 연결할 수 있습니다. 결제 UI는 변경되지 않습니다. 변경 사항은 지불 프로세스에만 영향을 미칩니다. 결제를 처리하면 플레이어의 돈이 PayPal 계정으로 이체됩니다. 이 경우 엑솔라는 지불 프로세스에 관여하지 않습니다.

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

고객 성공 매니저에게 문의하거나 csm@xsolla.com으로 이메일을 보내주세요. PGP 암호화를 사용하여 데이터를 보호해주세요.

엑솔라 PGP 키 매개변수:

  • 키 ID: FBA38225
  • 키 유형: RSA
  • 키 길이: 4096
  • 지문: 4D63 4B67 B265 5464 D39D 7228 67B0 672A FBA3 8225
  • 사용자 ID: admins@xsolla.com

Copy
Full screen
Small screen
  • html
-----BEGIN PGP PUBLIC KEY BLOCK-----
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
=7AyM
-----END PGP PUBLIC KEY BLOCK-----

오류 메시지

알림
결제 UI를 여는 동안 발생할 수 있는 오류에 대한 자세한 내용은 문서를 참조하세요.

0004-0008 오류가 발생한 경우 어떻게 해야 하나요?

다음과 같이 올바른 URL 주소를 사용하고 있는지 확인합니다.

2205 또는 2207 오류(사용자 ID 오류)가 발생한 경우 어떻게 해야 하나요?

  • 유효한 사용자 ID인 user_id을 데이터베이스로부터 전달하세요.
  • 웹훅 사용 관련 권장 사항:
    • 웹훅을 사용하지 않으려면 프로젝트에서 웹훅이 비활성화되어 있는지 확인하세요. 그렇게 하려면 관리자 페이지으로 이동하여 프로젝트 설정 > 웹훅 섹션에서 토글을 Off(끄기)로 설정하세요.
    • 웹훅을 사용하려면 사용자 검증 웹훅 처리를 성공적으로 구현하세요.

1000-0003 오류가 발생한 경우 어떻게 해야 하나요?

프로젝트에 해당하는 각 모듈을 활성화합니다.

0002-0004 오류가 발생한 경우 어떻게 해야 하나요?

지불 대금을 받으려면 엑솔라와의 라이선싱 계약에 서명해야 합니다. 도움이 필요하면 고객 성공 매니저에게 문의하거나 이메일 onboarding@xsolla.com으로 문의합니다.

3032 오류가 발생한 경우 어떻게 해야 하나요?

사용 가능한 커뮤니케이션 채널을 통해 통합 팀에 오류 또는 사용자 ID 및 프로젝트 ID가 있는 지불 토큰에 대한 정보를 보냅니다.
알림
열린 결제 UI의 URL 주소에서 결제 토큰을 확인할 수 있습니다. iframe에서 결제 UI를 연 경우 iframe을 마우스 오른쪽 버튼으로 클릭하고 드롭다운 목록에서 iframe의 소스를 볼 수 있는 옵션을 선택합니다.

웹훅 요청에서 인증 헤더가 누락된 이유는 무엇인가요?

이 오류를 수정하려면, .htaccess 혹은 httpd.conf 아파치 파일을 편집해야 합니다. 자세한 정보는 SDK 문서를 참조합니다.

연락처 정보

의문 사항에 대해 FAQ에서 답을 참지 못한 경우에는, 다음과 같은 다른 채널을 통해 문의하세요:
  • 우측 하단 채팅 아이콘을 클릭하여 메신저를 통해 통합팀에 문의하세요. 실시간으로 문제 해결을 위한 답변을 들을 수 있습니다.
  • integration@xsolla.com로 이메일을 보내셔도 됩니다.
  • 고객 성공 매니저에게 문의하거나 csm@xsolla.com으로 이메일을 보내주세요.
  • Basecamp를 통해 전문가에게 문의하세요.
고객 서비스 통합 가이드(PDF)
고객 서비스팀과 통합할 수 있는 옵션에 대해 알아보세요.
이 기사가 도움이 되었나요?
감사합니다!
개선해야 할 점이 있을까요? 메시지
유감입니다
이 기사가 도움이 안 된 이유를 설명해 주세요. 메시지
의견을 보내 주셔서 감사드립니다!
메시지를 검토한 후 사용자 경험 향상에 사용하겠습니다.
이 페이지 평가
이 페이지 평가
개선해야 할 점이 있을까요?

답하기 원하지 않습니다

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

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

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