결제 토큰을 가져오는 방법
결제 UI를 열려면 토큰을 받아야 합니다. 토큰은 게임과 사용자에 대한 암호화된 데이터가 포함된 문자열입니다. 구매를 허용하려면 사용자를 식별하기 위해 토큰 가져오기를 구현해야 합니다.
결제 토큰을 가져오는 방법:
사용자 인증 토큰 가져오기
토큰의 수명은 엑솔라 API를 마지막으로 호출한 후 24시간입니다. 토큰이 만료된 후 새 토큰을 받는 로직을 구현합니다. 사용자가 애플리케이션에 다시 로그인할 필요가 없도록 백그라운드에서 새 토큰을 받는 것이 좋습니다.
애플리케이션의 백엔드에서 사용자 인증 토큰 가져오기를 구현해야 합니다. 이렇게 하려면 기본 HTTP 인증이 포함된 HTTP POST 요청을 사용하고 요청 본문에 필수 매개변수를 전달합니다.
기본 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 | 인터페이스 언어. |
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"
}
결제 토큰 가져오기
결제 토큰을 가져오려면 주문을 생성합니다. 주문은 사용자가 스토어에서 구매하려는 아이템입니다. 주문 대금을 지불하면 사용자는 해당 아이템을 받습니다. 결제 절차를 테스트하려면 특정 아이템을 사용하는 주문 생성 API 호출을 사용하여 주문을 생성합니다.
- API 문서 웹사이트에서 테스트를 수행하려면
Try it 를 클릭하여 요청을 생성하는 인터페이스를 엽니다. Security 블록과Bearer Token 필드에서 인증 절차를 통과하는 동안 획득한 토큰을 입력합니다.Body 블록에서 아이템 수량과 같은 주문 세부 정보를 전달합니다. 샌드박스 모드에 액세스하려면"sandbox": true
를 전달합니다.Parameters 블록에서 다음을 전달합니다.project_id
- 관리자 페이지에서 확인할 수 있는 프로젝트 IDitem_sku
- 아이템 SKU
token
- 결제 토큰
오자 또는 기타 텍스트 오류를 찾으셨나요? 텍스트를 선택하고 컨트롤+엔터를 누르세요.