결제 토큰을 가져오는 방법

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

결제 토큰을 가져오는 방법:

  1. 사용자 인증 토큰을 가져옵니다.
  2. 주문을 생성합니다.

알림
기본적으로 토큰의 수명은 24시간입니다. 이 값을 변경하려면 계정 관리자에게 문의하거나 csm@xsolla.com으로 이메일을 보내주세요. 새 값은 관리자 페이지에서 생성한 회사의 모든 프로젝트에서 활성화됩니다.

사용자 인증 토큰 가져오기

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

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

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

기본 HTTP 인증

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

  • 판매자 ID 표시 위치:
    • 회사 설정 > 회사 섹션.
    • 관리자 페이지의 브라우저 주소 표시줄에 있는 URL. 해당 URL은 https:​//publisher.xsolla.com/<merchant ID>/<Publisher Account section> 형식으로 되어 있습니다.

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

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

주요 권장 사항:

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

필요로 하는 API 호출에 project_id 경로 매개 변수가 포함되어 있지 않으면 회사의 모든 프로젝트에서 유효한 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"
      }
      

      결제 토큰 가져오기

      결제 토큰을 가져오려면 주문을 생성합니다. 주문은 사용자가 스토어에서 구매하려는 아이템입니다. 주문 대금을 지불하면 사용자는 해당 아이템을 받습니다. 결제 절차를 테스트하려면 특정 아이템을 사용하는 주문 생성 API 호출을 사용하여 주문을 생성합니다.

      1. API 문서 웹사이트에서 테스트를 수행하려면 Try it를 클릭하여 요청을 생성하는 인터페이스를 엽니다.
      2. Security 블록과 Bearer Token 필드에서 인증 절차를 통과하는 동안 획득한 토큰을 입력합니다.
      3. Body 블록에서 아이템 수량과 같은 주문 세부 정보를 전달합니다. 샌드박스 모드에 액세스하려면 "sandbox": true를 전달합니다.
      4. Parameters 블록에서 다음을 전달합니다.
        • project_id - 관리자 페이지에서 확인할 수 있는 프로젝트 ID
        • item_sku - 아이템 SKU
      알림
      엑솔라 API를 호출하기 위해 게임 엔진 및 플랫폼에 이미 만들어진 SDK 메소드를 사용할 수 있습니다.

      응답으로 다음 작업에 필요한 데이터를 받게 됩니다.

      • token - 결제 토큰

      이 기사가 도움이 되었나요?
      감사합니다!
      개선해야 할 점이 있을까요? 메시지
      유감입니다
      이 기사가 도움이 안 된 이유를 설명해 주세요. 메시지
      의견을 보내 주셔서 감사드립니다!
      메시지를 검토한 후 사용자 경험 향상에 사용하겠습니다.
      마지막 업데이트: 2024년 10월 3일

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

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