샌드박스 모드

샌드박스 모드는 실제 결제를 제외한 라이브 환경의 모든 기능을 지원하는 독립형 환경입니다. 샌드박스 모드로 테스트할 수 있는 항목:

  • 결제 위젯
  • 수령인 계정
  • 신원 확인 절차(KYC) 및 세금 신고를 통과하기 위한 양식
  • API와의 연동

결제 위젯

샌드박스 모드로 결제 위젯을 여는 방법:

  1. 토큰을 가져옵니다. 요청에서 Authorization:Basic <your_authorization_basic_key> 매개변수를 전달합니다. 여기서 <your_authorization_basic_key>는 Base64 표준에 따라 인코딩된 플랫폼 ID: 비밀 키 쌍입니다. 이 테스트 데이터를 찾는 방법:
    1. 관리자 페이지에서 프로젝트를 열고 페이아웃 솔루션 > 설정 섹션으로 이동합니다.
    2. 오른쪽 상단 모서리에 있는 드롭다운 목록에서 샌드박스를 선택합니다.
    3. 설정 > 보안 섹션으로 이동합니다.

토큰을 구하는 요청의 예시:

Copy
Full screen
Small screen
    curl -X POST 'https://payouts-sandbox-api.xsolla.com/api/v1/merchants/customer/auth' \
    -H 'Content-Type: application/json' \
    -H 'Authorization: Basic <your_authorization_basic_key>' \
    -d '{"email": "<your email>", "name": "<your name>"}'
    
    1. https://payouts-sandbox-widget.xsolla.com/?token={token} 링크를 사용하여 샌드박스 모드를 엽니다. 여기서 {token}1단계에서 수령한 토큰입니다.
    알림
    SDK를 사용하여 위젯 열기

    샌드박스 모드에서 결제 위젯을 열려면 위젯을 여는 스크립트 또는 npm 패키지의 초기화 코드에서 sandbox: true 매개 변수를 전달합니다.

    결제 위젯을 여는 스크립트:

    Copy
    Full screen
    Small screen
      <script>
          var s = document.createElement('script');
          s.type = "text/javascript";
          s.async = true;
          s.src = "https://static.xsolla.com/payouts/v0/_bundles/santorelli.min.js";
          s.addEventListener('load', function () {
              const widget = new XPayoutsWidget.Widget({
                          token: '<auth token>',
                          theme: 'black',
                          size: 'fixed',
                          sandbox: true
                      });
      
              widget.show('<container_id>');
      
              widget.addEventListener('load', () => {
                  console.log('loaded');
              });
          }, false);
          var head = document.getElementsByTagName('head')[0];
          head.appendChild(s);
      </script>
      

      결제 위젯을 여는 초기화 코드:

      Copy
      Full screen
      Small screen
        import {Widget} from '@xsolla/payouts-sdk';
        
        const widget = new Widget({
        	token: '<auth token>',
        	theme: 'black',
        	size: 'fixed',
        	sandbox: true  
        });
        
        widget.show('<container_id>');
        
        widget.addEventListener('load', () => {
        	console.log('loaded');
        });
        

        1. 위젯이 열리면 라이선스 계약을 읽고 이에 동의하는 확인란을 선택합니다.
        2. Verification 탭에서 테스트 데이터를 필드에 입력합니다.
          • 이름
          • 중간 이름(필수 아님)
          • 국가
          • 국적
        3. 실패한 시나리오를 테스트하려면 신원 확인 절차(KYC)를 통과할 때 오류 생성 확인란을 선택 표시합니다.
        4. Send를 클릭합니다.
        1. Tax Interview 탭에서 테스트할 시나리오(성공 또는 오류)를 선택합니다.
        2. 테스트 데이터을 사용하여 결제를 진행합니다.
        알림
        샌드박스 모드에서 진행한 트랜잭션은 프로덕션 환경에 영향을 미치지 않습니다.

        수령인 계정

        샌드박스 모드에서 수령인 계정을 여는 방법:

        1. 관리자 페이지에서 프로젝트를 열고 페이아웃 솔루션 > 설정 섹션으로 이동합니다.
        2. 오른쪽 상단 모서리의 드롭다운 목록에서 샌드박스를 선택합니다.

        1. 사용자 탭으로 이동하여 본인 초대를 클릭합니다.
        2. 본인의 이메일 주소로 받은 이메일에서 수령인 계정으로 연결되는 링크를 따라갑니다.
        3. 수령인 계정에서 판매자를 선택하고 테스트 데이터를 사용하여 결제를 진행합니다.
        알림
        https://payouts-sandbox.xsolla.com/ 링크를 따라 샌드박스 수령인 계정으로 이동하여 인증 절차를 통과할 수도 있습니다.

        테스트 데이터

        주의
        테스트 목록에 포함되지 않은 데이터는 샌드박스 모드에서 작동하지 않습니다.

        테스트 카드

        카드 번호CVC만료일설명
        4242424242424242숫자 3자리미래의 모든 날짜성공적인 결제
        4000000000000002숫자 3자리미래의 모든 날짜실패한 결제

        테스트 트랜잭션

        IBAN기타 필드설명
        FI211234569876543210모든 데이터성공적인 인출
        AT483200000012345864모든 데이터실패한 인출

        테스트 이메일 주소

        이메일 주소기타 필드설명
        success@xsolla.com모든 데이터성공적인 인출
        failed@xsolla.com모든 데이터실패한 인출

        테스트 전화번호

        전화번호기타 필드설명
        +1 (555) 123-4567모든 데이터성공적인 인출
        +1 (555) 987-6543모든 데이터실패한 인출
        이 기사가 도움이 되었나요?
        감사합니다!
        개선해야 할 점이 있을까요? 메시지
        유감입니다
        이 기사가 도움이 안 된 이유를 설명해 주세요. 메시지
        의견을 보내 주셔서 감사드립니다!
        메시지를 검토한 후 사용자 경험 향상에 사용하겠습니다.
        이 페이지 평가
        이 페이지 평가
        개선해야 할 점이 있을까요?

        답하기 원하지 않습니다

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

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

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