토큰 가져오기

결제 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 키

요청 본문

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

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

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

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>"
      }
    }
  }'

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

{
    "token": "1230OWrp0KF6uqvmN8jWuzLyoXMzxTyK_lc_en"
}