토큰 가져오기

결제 UI를 열려면 토큰을 받아야 합니다. 토큰은 게임과 사용자에 대한 암호화된 데이터가 포함된 문자열입니다. 구매를 허용하려면 사용자를 식별하기 위해 토큰 가져오기를 구현해야 합니다.

애플리케이션의 백엔드에서 사용자 인증 토큰 가져오기를 구현해야 합니다. 이렇게 하려면 기본 HTTP 인증이 포함된 HTTP POST 요청을 사용하고 요청 본문에 필수 매개변수를 전달합니다.

API 참조
매개 변수 전체 목록을 봅니다.

토큰의 수명은 엑솔라 API를 마지막으로 호출한 후 14시간입니다. 토큰이 만료된 후 새 토큰을 받는 로직을 구현합니다. 사용자가 애플리케이션에 다시 로그인할 필요가 없도록 백그라운드에서 새 토큰을 받는 것이 좋습니다.

기본 HTTP 인증

엑솔라 API는 기본 액세스 인증을 사용합니다. 모든 API 요청에는 Authorization: Basic <your_authorization_basic_key> 헤더가 있어야 합니다. 여기에서 <your_authorization_basic_key>는 Base64 표준으로 인코딩된 판매자 ID:API 키 쌍입니다. 이러한 매개변수를 찾으려면 게시자 계정으로 이동합니다.

  • 판매자 ID 표시 위치:
    • 프로젝트 설정 > 웹훅 섹션
    • 회사 설정 > 회사 섹션
    • 게시자 계정 페이지의 브라우저 주소 표시줄에 있는 URL. 이 URL의 형식: https://publisher.xsolla.com/​판매자 ID/게시자 계정 섹션

  • API 키는 생성할 때 한 번만 게시자 계정에 표시되며 따로 저장하고 관리해야 합니다. 다음 섹션에서 새 키를 생성할 수 있습니다.
    • 회사 설정 > API 키
    • 프로젝트 설정 > API 키

주의

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

주요 권장 사항:

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

요청 본문

요청 본문에서 다음 필수 매개변수를 전달하세요.

매개 변수유형설명
user.id
string시스템의 고유 사용자 ID.
user.email
string구매 영수증을 전송할 사용자 이메일. 매개변수를 전달하지 않으면 결제 페이지에서 이메일 입력을 위한 필수 필드가 표시됩니다.
settings.project_id
integer게임의 엑솔라 ID. 이 정보는 게시자 계정의 프로젝트 섹션에서 확인할 수 있습니다.

사용자 환경 개선을 위해 다음 매개변수를 전달할 수도 있습니다.

매개 변수유형설명
user.name
string영수증에 표시되는 사용자 화면 이름.
settings.currency
string선호하는 결제 통화.
settings.language
string인터페이스 언어.

사용자 인증 토큰을 가져오는 요청의 예시

Copy
Full screen
Small screen

    curl -i -X POST \
      -u 2340:ZHgbSDVP6LtAJVWu \
      https://api.xsolla.com/merchant/v2/merchants/<merchant_id>/token \
      -H 'Content-Type: application/json' \
      -d '{
        "settings": {
          "currency": "USD",
          "language": "en",
          "project_id": <project_id>
          }
        },
        "user": {
          "email": {
            "value": "<user_email>"
          },
          "id": {
            "value": "<user_id>"
          },
          "name": {
            "value": "<user_name>"
          }
        }
      }'

    응답으로 수신한 사용자 인증 토큰의 예시

    Copy
    Full screen
    Small screen

      {
          "token": "1230OWrp0KF6uqvmN8jWuzLyoXMzxTyK_lc_en"
      }

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

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

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