결제 설정
사용자 유효성 검사
사용자 ID란 무엇인가요?
사용자 ID는 게임에서 사용자 식별에 사용할 수 있는 매개 변수입니다. 데이터베이스에 사용자 ID를 저장할 수 있습니다. 유효하지 않은 사용자 ID를 수신하면 예외가 발생합니다. 사용자 유효성 검사의 예시는 GitHub 저장소를 참조합니다.
유효성 검사를 완료한 후 어떤 데이터를 반환해야 하나요?
유효성 검사가 성공적인 경우 HTTP-코드 200을 반환합니다. 오류가 발생하면 코드 400(INVALID_USER)을 반환합니다.
사용자 정의
결제 UI 테마를 사용자 정의할 수 있나요?
토큰에서 settings.ui.theme = default_dark 매개 변수를 전송하여 다크 테마를 활성화할 수 있습니다. 다크 테마를 사용하여 배경 이미지를 설정하거나 배경 색상을 변경할 수 있습니다(데모 참조). 다른 설정을 변경하려면 고객 성공 매니저에게 문의하거나 csm@xsolla.com으로 이메일을 보내주세요.
사용자에게 전송하는 이메일의 표시 형식을 변경할 수 있나요?
예. 사용자에게 보내는 이메일 맞춤 설정 방법 지침을 따릅니다. 이메일 구성 요소의 순서는 표준 템플릿 일부이기에 변경할 수 없습니다. 이는 기록상 법적 판매자인 엑솔라와의 라이선싱 계약에 따라 이는 요구되는 사항입니다.
테스트
테스트 은행 카드를 사용하여 결제 프로세스를 테스트할 수 있나요?
예. 다만 샌드박스 모드로 애플리케이션 혹은 페이 스테이션 데모를 실행하는 경우에만 가능합니다. 다른 브랜드 및 발급 국가의 테스트 은행 카드의 일반 목록을 참조합니다.
샌드박스 모드로 PayPal 결제를 테스트해볼 수 있나요?
예. 지침에서 자세한 정보를 참조해주세요.
결제 환불을 테스트하려면 어떻게 해야 하나요?
환불 요청 API 호출을 통해 환불을 테스트할 수 있습니다. 자세한 내용은 지침을 참조합니다.
관리자 페이지의 엑솔라 인보이스 ID 및 웹훅 테스트 탭의 인보이스 ID는 무엇인가요?
엑솔라 인보이스 ID는 엑솔라의 거래 ID입니다. 테스트를 수행하는 경우 임의의 숫자를 입력하여 사용할 수 있습니다.
인보이스 ID는 게임의 선택적 거래 ID입니다. 테스트를 수행하는 경우 문자와 숫자를 조합하여 입력할 수 있습니다.
페이먼트 솔루션
웹훅에서 받은 결제 요청을 확인할 수 있으려면 어떻게 해야 하나요?
먼저, 지정한 사용자 ID가 프로젝트에 있는지 확인합니다. 그런 다음 200 코드를 반환하여 결제의 유효성을 확인합니다.
사용자를 특정 결제 방법으로 리디렉션할 수 있나요?
스토어 UI를 열 때 settings.payment_method 매개 변수에서 결제 방식 ID를 전달할 수 있습니다. 이 경우 사용자는 선택한 결제 방식의 결제 양식으로 리디렉션됩니다. 결제 > 결제 방식 섹션의 관리자 페이지에서 결제 방식 ID 목록을 확인할 수 있습니다.
결제를 처리한 후 결과에 따라 자동으로 사용자를 성공/실패 결제 페이지로 리디렉션할 수 있나요?
예, 리디렉션 조건을 구성할 수 있습니다. 자세한 내용은 지침을 참조합니다.
당사 결제 시스템은 각 주문에 대해 order_id를 자동으로 설정합니다. 토큰을 수신할 때 user_id 대신 order_id를 사용할 수 있나요?
아니요, 모든 작업을 올바르게 수행하려면 user_id가 필요합니다.
external_id 매개 변수의 order_id를 추가로 전달할 수 있습니다. 수행 방법:
- 관리자 페이지에서 프로젝트를 열고 프로젝트 설정 > 통합 설정 섹션으로 이동합니다.
- 외부 ID 사용 확인란을 선택합니다.
- 저장을 클릭합니다.
각 거래별로 웹훅 URL을 재정의할 수 있나요?
아니요. 모든 거래의 웹훅 URL은 관리자 페이지의 프로젝트 설정에서 설정할 수 있습니다.
실패한 거래의 세부 정보를 받게 되나요?
아니요. 엑솔라는 거래에 성공한 경우에만 웹훅을 전송합니다. 결제 알림을 받았다면 거래가 성공적으로 이루어진 것입니다.
총 결제 금액에 VAT를 추가할 수 있으려면 어떻게 해야 하나요?
VAT 설정은 기본적으로 엑솔라에서 구성합니다. 설정을 변경하고 사용자의 총 결제 금액에 VAT를 추가하려면 고객 성공 매니저에게 문의하거나 csm@xsolla.com으로 이메일을 보내주세요.PID는 무엇의 약자인가요?
PID는 엑솔라에서 사용하는 결제 방법 식별자입니다.
외부 ID란 무엇인가요?
외부 ID는 시스템의 주문에 할당된 게임의 트랜잭션의 ID입니다. 엑솔라 측에서 외부 ID는 트랜잭션 ID에 연결됩니다. 그렇기 때문에 외부 ID를 활성화하면 엑솔라에서 동일한 거래에 대한 반복 결제를 방지할 수 있습니다.
“external_id”: “1”을 포함한 테스트 결제가 있는 경우, “external_id”: “1”로 실제로 결제할 수 없습니다.- 관리자 페이지에서 프로젝트를 열고 프로젝트 설정 > 통합 설정 섹션으로 이동합니다.
- 결제 섹션에서 필요한 확인란을 선택합니다:
- 외부 ID 사용 - 토큰 생성 시 외부 ID 유효성 검사가 필요하도록 설정합니다.
- 외부 ID에 대한 인증 건너뛰기 - 토큰 생성 시 외부 ID 유효성 검사를 비활성화할 수 있습니다.
- 저장을 클릭합니다.
외부 ID 사용 설정이 활성화된 경우, 관리자 페이지를 통한 테스트 결제를 완료할 수 없습니다. 테스트 결제를 성공적으로 수행하려면 이 설정을 일시적으로 비활성화하세요.
각 거래마다 새로운 외부 ID를 생성해야 하나요?
예. 외부 ID는 각 결제마다 고유해야 합니다.
setExternalPaymentId 메서드에 대해 어떠한 값을 설정해야 하나요?
보유하고 있는 경우 setExternalPaymentId 메서드는 external_id의 값과 같게 설정해야 합니다.
게이트웨이란 무엇인가요?
결제 시스템과의 계약을 체결하면 게이트웨이를 사용하여 결제 UI에 이러한 결제 옵션을 표시할 수 있습니다. 플레이어는 여전히 선택한 결제 방법을 사용하여 구매 대금을 지불할 수 있으며 해당 결제 시스템 제공업체로부터 판매 대금을 직접 받게 됩니다. 게이트웨이를 연결하려면 관리자 페이지에서 프로젝트를 열고 결제 > 결제 설정 > 게이트웨이 섹션으로 이동합니다.
엑솔라는 기술 서비스 제공자의 역할만 수행하며 한정적인 매출 수수료(거래 금액의 1.25% +$0.10)를 받습니다. 여러분은 모든 엑솔라 솔루션에 대한 전체 액세스 권한을 갖지만 다음 사항은 직접 수행해야 합니다.
- 세금 관련 문제 관리
- 각 결제 시스템과 별도의 계약 체결
- 지불 시스템으로부터 직접적인 자금 흐름을 보유
- 결제 시스템 수수료, 지불 거절 및 환불, 지불 수수료 및 운영 비용 관리
예를 들어 PayPal을 직접 결제 수단으로 설정하려는 경우 여러분은 게이트웨이를 연결할 수 있습니다. 결제 UI는 변경되지 않습니다. 변경 사항은 지불 프로세스에만 영향을 미칩니다. 결제를 처리하면 플레이어의 돈이 PayPal 계정으로 이체됩니다. 이 경우 엑솔라는 지불 프로세스에 관여하지 않습니다.
엑솔라에 사용자 데이터(저장한 결제 계정, 정기 결제 등)를 어떻게 마이그레이션할 수 있습니까?
고객 성공 매니저에게 문의하거나 csm@xsolla.com으로 이메일을 보내주세요. PGP 암호화를 사용하여 데이터를 보호해주세요.
엑솔라 PGP 키 매개 변수:
- 키 ID: DA1E62CB
- 키 유형: RSA
- 키 길이: 4096
- 지문: 0209 8489 757F 4451 F431 FB0C FBFC 4D97 DA1E 62CB
- 사용자 ID: admins@xsolla.com
1-----BEGIN PGP PUBLIC KEY BLOCK-----
2
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
62=naL7
63-----END PGP PUBLIC KEY BLOCK-----
사용자의 국가는 어떻게 판별하나요?
결제 토큰 생성을 위한 클라이언트 측 API 호출을 사용하는 경우 엑솔라는 요청의 IP 주소에서 사용자의 국가를 확인합니다.
결제 토큰 생성을 위한 서버 측 API 호출을 사용하는 경우 국가는 다음 사항을 순차적으로 확인하여 판별됩니다.
- 요청 본문에서
user.country.value매개 변수 X-User-Ip헤더
이 값 중 어느 것도 전달되지 않으면 오류가 표시됩니다. 이 두 값이 모두 전달되면 요청 본문의 정보가 사용됩니다.
오자 또는 기타 텍스트 오류를 찾으셨나요? 텍스트를 선택하고 컨트롤+엔터를 누르세요.
