빠른 시작

통합 절차

결제 솔루션 통합 방법:

관리자 페이지에서 프로젝트를 생성합니다. 하나의 프로젝트는 하나의 게임에 해당합니다. 게임이 여러 개 있는 경우 각 게임마다 프로젝트를 추가해야 합니다.
엑솔라 측 카탈로그에 판매하려는 아이템을 추가합니다.
사용자가 결제할 주문 생성하는 테스트를 진행합니다.
구매 테스트를 진행하고 알림을 설정합니다.
실제 결제 처리를 시작하려면 관리자 페이지에서 엑솔라와 라이선스 계약을 체결합니다.

모든 연동 단계에서 라이선스 계약에 서명할 수 있지만, 검토 절차에 최대 3일(영업일 기준)이 소요될 수 있다는 점에 유의해 주세요.

카탈로그 생성하기

가상 아이템은 사용자가 실제 통화 및 인게임 재화로 구매할 수 있는 인게임 콘텐츠입니다. 엑솔라 측에서 가상 아이템 카탈로그를 생성하면 지역별 가격 및 제한을 사용자 정의할 수 있을 뿐만 아니라 정기적으로 추가 및 업데이트되는 엑솔라의 프로모션 및 기타 기능 시스템을 사용할 수도 있습니다.

가상 아이템 만들기

아이템 목록 가져오기

아이템 목록을 가져오려면 가상 아이템 목록 가져오기 API 메소드를 호출합니다.

요청 헤더에서 기본값으로 인증에 사용되는 엑솔라 로그인 JWT(전달자 토큰)를 전달합니다. 이 API 메소드 호출을 테스트하기 위해 다음 테스트 토큰을 사용할 수 있습니다.Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJleHAiOjE5NjIyMzQwNDgsImlzcyI6Imh0dHBzOi8vbG9naW4ueHNvbGxhLmNvbSIsImlhdCI6MTU2MjE0NzY0OCwidXNlcm5hbWUiOiJ4c29sbGEiLCJ4c29sbGFfbG9naW5fYWNjZXNzX2tleSI6IjA2SWF2ZHpDeEVHbm5aMTlpLUc5TmMxVWFfTWFZOXhTR3ZEVEY4OFE3RnMiLCJzdWIiOiJkMzQyZGFkMi05ZDU5LTExZTktYTM4NC00MjAxMGFhODAwM2YiLCJlbWFpbCI6InN1cHBvcnRAeHNvbGxhLmNvbSIsInR5cGUiOiJ4c29sbGFfbG9naW4iLCJ4c29sbGFfbG9naW5fcHJvamVjdF9pZCI6ImU2ZGZhYWM2LTc4YTgtMTFlOS05MjQ0LTQyMDEwYWE4MDAwNCIsInB1Ymxpc2hlcl9pZCI6MTU5MjR9.GCrW42OguZbLZTaoixCZgAeNLGH2xCeJHxl8u8Xn2aI.
project_id 경로 매개 변수에서 관리자 페이지에서 확인할 수 있는 프로젝트 ID를 전달합니다.

응답으로 프로젝트에서 생성된 가상 아이템에 대한 자세한 정보를 받게 됩니다. 이후 주문을 생성하려면 items.sku 매개 변수에서 전달된 아이템 SKU가 필요합니다.

주문 생성

주문은 사용자가 스토어에서 구매하려는 아이템으로 구성됩니다. 주문을 결제한 후 사용자는 아이템을 수령합니다. 결제하려면 사용자가 게임에서 인증 받아야 합니다.

설정 지침을 확인하려면 게임에 적합한 연동 메소드를 선택하세요.

특징	서버 측	클라이언트 측
서버 보유	토큰을 받고 서버의 부하를 제어하려면 자체 서버가 있어야 합니다.	자체 서버를 보유할 필요는 없습니다.
사용자 국가 결정	결제 토큰에서 국가 또는 IP 주소를 전달해야 합니다. 이는 결제 방식의 사용 가능 여부에 영향을 줍니다.	엑솔라가 IP 주소로 사용자의 국가를 결정합니다.
결제 통화 결정	토큰에서 통화를 전달하지 않으면 국가에 따라 결정됩니다. 토큰에서 통화를 전달하면 사용자가 해당 통화로 결제를 진행합니다.	통화는 국가에 따라 결정됩니다.

구매용 결제 토큰 생성 API 메소드를 호출하고 이 메소드의 사용자 및 아이템에 대한 정보를 전달합니다. 이 API 호출을 사용하여 아이템 하나와 아이템 여러 개를 판매할 수 있습니다.

샌드박스 모드를 사용하려면 토큰 가져오기 요청 본문에서 “sandbox”: true 매개 변수를 전달하세요.

user_id 매개 변수의 값:

테스트할 때 이 매개 변수에서 어떤 기호든 전달할 수 있습니다.
실제 결제를 수락하려면 이 매개 변수에서 시스템의 사용자 ID를 전달합니다. 이 ID는 사용자 유효성 검사 웹훅에서 전달됩니다.

요청 예제:

Copy

Full screen

Small screen

curl -i -X POST \
  -u 224575:MYAPIKEY \
  https://store.xsolla.com/api/v2/project/224575/admin/payment/token \
  -H 'Content-Type: application/json' \
  -d '{
    "user": {
      "id": {
        "value": "myUserID"
      }
    },
    "purchase": {
      "items": [
        {
          "sku": "mySKU",
          "quantity": 1
        }
      ]
    },
    "sandbox": true
  }'

엑솔라 로그인 연동 방법:

구성된 로그인 메소드를 사용하여 인증 토큰을 생성하고 저장하여 결제 토큰을 받습니다. 결제 토큰은 결제 UI를 열고 결제하는 데 사용됩니다.

결제 절차를 테스트하려면 지정된 아이템으로 주문 생성 API 호출을 사용하여 주문을 생성합니다.

API 문서 웹사이트에서 테스트를 수행하려면 Try it를 클릭한 후 요청 생성용 인터페이스를 엽니다.
Security 블록의 Bearer Token 필드에 인증 절차를 통과하는 동안 입수한 토큰을 입력합니다.
Body 블록에서 아이템 수량과 같은 주문 세부 사항을 전달합니다. 샌드박스 모드에 액세스하려면 "sandbox": true를 전달합니다.
Parameters 블록에서 다음을 전달합니다.
- project_id - 관리자 페이지에서 확인할 수 있는 프로젝트 ID 입니다.
- item_sku - 아이템 SKU입니다.

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

token - 결제 토큰

요청 예제:

Copy

Full screen

Small screen

curl -i -X POST \
  'https://store.xsolla.com/api/v2/project/{project_id}/payment/item/{item_sku}' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "sandbox": true,
    "quantity": 5,
    "settings": {
      "ui": {
        "theme": "63295a9a2e47fab76f7708e1",
      }
    },
    "custom_parameters": {
      "character_id": "ingameUsername"
    }
  }'

엑솔라 API를 호출하기 위해 게임 엔진 및 플랫폼에 이미 만들어진 SDK 메소드를 사용할 수 있습니다.

테스트 구매하기

테스트를 진행하는 동안에는 실제 은행 계좌에서 돈을 인출할 필요가 없으며, 테스트 카드 중 하나를 사용할 수 있습니다.

엑솔라와 계약을 체결하기 전에는 샌드박스 모드에서만 결제 프로세스를 테스트할 수 있습니다.

샌드박스 모드에서 결제 UI 열기

새 창에서 결제 UI를 열려면 https://sandbox-secure.xsolla.com/paystation4/?token=TOKEN URL을 사용합니다. 여기서 TOKEN는 주문을 생성할 때 획득한 토큰입니다.

다른 방법으로 결제 UI를 열려면 문서를 참조하세요.

테스트 결제하기

샌드박스 모드로 결제 UI를 엽니다.
은행 카드 결제 방식을 선택합니다.
은행 카드 세부 정보를 입력합니다. 다른 필드(예: 이름 또는 주소)에는 아무 데이터나 입력할 수 있습니다. 오류가 생성되는지 확인하기 위해 잘못된 세부 정보(카드 번호 또는 만료일)를 입력할 수도 있습니다.
지불을 클릭합니다.

테스트 카드 목록

테스트 은행 카드 목록을 봅니다.

우편번호에 대한 정보

카드 세부 정보 외에도 다음 조건 중 하나라도 충족하는 경우 우편번호를 지정해야 합니다.

사용자의 국가가 미국 또는 캐나다입니다.
은행 식별 번호(BIN)가 카드가 미국에서 발급되었음을 나타냅니다.

유효한 우편번호(예: 12345)를 지정할 수 있습니다. 이는 판매 세율을 결정하며 결제 테스트 진행에 영향을 주지 않습니다.
샌드박스 은행 카드 결제를 진행할 수 있는 통화: USD, EUR, RUB, GBP, AED, ALL, AMD, ARS, AUD, AZN, BGN, BRL, BYN, CAD, CHF, CLP, CNY, COP, CZK, DKK, DZD, EGP, GEL, HKD, HRK, HUF, IDR, ILS, INR, ISK, JPY, KES, KGS, KRW, KZT, MAD, MDL, MKD, MNT, MXN, MYR, NGN, PEN, PHP, PKR, PLN, RON, RSD, SAR, SEK, SGD, THB, TRY, TWD, UAH, UYU, UZS, VEF, VND, ZAR.

샌드박스 모드에서는 은행 카드 및 PayPal을 사용하여 일회성 결제 및 저장된 결제 방법으로 결제를 테스트할 수 있습니다.

웹훅 설정

서버 측에서 연동을 설정하는 경우, 웹훅에 대한 응답으로 해당 코드 전송을 통해 생성된 주문의 유효성을 검사해야 합니다. 클라이언트 측에서 연동을 설정하는 경우 웹훅을 통해 구성된 이벤트(예: 결제 상태 변경)에 대한 알림을 받을 수 있습니다.

웹훅 수신을 활성화하는 방법:

관리자 페이지에서 프로젝트를 엽니다.
사이드 메뉴에서 프로젝트 설정을 클릭하고 웹훅 솔루션 탭으로 이동합니다.
웹훅 서버 필드에서 https://example.com 형식으로 웹훅을 수신할 서버의 URL을 지정합니다. 웹훅 테스트용 도구에서 확인한 URL을 지정할 수도 있습니다.
프로젝트 웹훅에 서명하는 비밀 키는 기본값으로 생성됩니다. 새 비밀 키를 생성하려면 새로 고침 아이콘을 클릭합니다.
웹훅 사용을 클릭합니다.

PHP SDK

웹훅 처리용으로 준비된 클래스 사용.

웹훅을 테스트하기 위해 webhook.site 같은 전용 웹사이트나 ngrok 같은 플랫폼을 선택할 수 있습니다.

사용자 유효성 검사 및 결제 성공에 대한 알림을 받으려면 다음 웹훅을 구성합니다.

사용자 유효성 검사 - 사용자가 게임에 등록되었는지 확인하는 알림 제공
결제 - 결제가 완료되었다는 알림 제공

웹훅 설정 및 테스트에 대한 자세한 내용은 문서를 참조해 주세요.

웹훅 수신기 구성

웹훅 수신기는 지정된 URL 주소에서 들어오는 웹훅을 수신하고 서명을 생성한 후 엑솔라 웹훅 서버로 응답을 전송할 수 있는 프로그램 코드입니다.

서명 생성 및 웹훅에 대한 응답 전송에 대한 정보

서명 생성

웹훅을 수신할 때는 데이터 전송의 보안을 보장해야 합니다. 이를 위해서는 웹훅 데이터에서 서명을 생성하고 생성된 서명이 HTTP 요청 헤더에 전송된 서명과 일치하는지 확인해야 합니다. 서명 생성 방법:

요청 본문과 프로젝트의 비밀 키의 JSON을 연결합니다.
첫 번째 단계에서 구한 문자열에 SHA-1 암호화 해시 함수를 적용합니다.

웹훅으로 응답 보내기

웹훅 수신을 확인하려면 서버가 다음을 반환해야 합니다.

성공적인 응답의 경우 200, 201 또는 204 HTTP 코드
지정된 사용자를 찾을 수 없거나 잘못된 서명이 전달된 경우 문제 설명이 포함된 400 HTTP 코드

서버에 일시적인 문제가 발생한 경우 웹훅 핸들러가 5xx 코드를 반환할 수도 있습니다. 주문 결제 성공 및 주문 취소 웹훅에 대한 응답을 받지 못했거나 5xx 코드가 포함된 응답을 받은 경우, 다음 일정에 따라 웹훅이 다시 전송됩니다.

5분 간격으로 2번
15분 간격으로 7번
60분 간격으로 10번

웹훅 전송은 처음 시도 후 12시간 이내에 최대 20번까지 시도할 수 있습니다. 결제 웹훅에 대한 응답이 수신되지 않았거나 5xx 코드가 포함된 응답이 수신된 경우 웹훅도 증가된 시간 간격으로 재전송됩니다. 12시간 동안 최대 12번 시도할 수 있습니다. 사용자 유효성 검사 웹훅에 대한 응답이 수신되지 않았거나 400 또는 5xx 코드가 포함된 응답이 수신된 경우 사용자 유효성 검사 웹훅이 재전송되지 않습니다. 이 경우 사용자에게 오류가 표시되며 결제와 주문 결제 성공 웹훅은 전송되지 않습니다.

런칭

라이선스 계약에 서명하기 전에는 샌드박스 모드로만 결제 UI를 열 수 있습니다.

라이선스 계약에 서명

라이선스 계약에 서명하면 엑솔라에서 지원하는 모든 결제 방식을 통해 실제 결제를 받을 수 있습니다. 라이선스 계약에 서명하는 방법:

관리자 페이지을 엽니다.
사이드 메뉴에서 계약 및 세금 > 계약 섹션으로 이동합니다.
라이선싱 계약 탭으로 이동한 후 신청서 작성을 클릭합니다.
해당 필드에 정보를 입력합니다.

신청서 검토에는 영업일 기준 3일 정도 걸립니다. 검증 절차를 진행하는 동안 질문이 있는 경우 엑솔라는 신청서에 표시된 담당자에게 연락합니다. 엑솔라 측의 확인 절차가 완료되면 계약 상태가 서명됨으로 변경됩니다.

프로덕션 환경으로 전환하기

실제 첫 지불 이후, 엄격한 샌드박스 지불 정책이 적용됩니다. 샌드박스 모드에서의 지불은 회사 설정 > 사용자 섹션의 관리자 페이지에서 지정된 사용자에 한해서만 가능합니다.

이전 단계를 완료하면 실제로 결제하도록 설정할 수 있습니다.

엑솔라와의 라이선스 계약에 서명했는지 확인합니다.
토큰을 입수할 때 요청 본문에서 “sandbox”: true 매개변수를 제거합니다.
https://secure.xsolla.com/paystation4/?token=TOKEN 링크를 사용하여 결제 UI를 엽니다.

본 가이드는 연동을 빠르게 시작하는 데 필요한 최소 설정을 설명합니다. 질문이 있을 경우 페이지 오른쪽 하단의 엑솔라 채팅을 통해 문의하거나 고객 성공 매니저에게 csm@xsolla.com으로 이메일을 보내주세요.

의견을 보내 주셔서 감사드립니다!

메시지를 검토한 후 사용자 경험 향상에 사용하겠습니다.

이 페이지 평가

답하기 원하지 않습니다

의견을 보내 주셔서 감사드립니다!

마지막 업데이트: 2024년 3월 18일

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

Your browser is not supported. Please try a different browser

페이먼트 솔루션

빠른 시작

통합 절차

카탈로그 생성하기

가상 아이템 만들기

아이템 목록 가져오기

주문 생성

테스트 구매하기

샌드박스 모드에서 결제 UI 열기

테스트 결제하기

웹훅 설정

웹훅 수신기 구성

서명 생성

웹훅으로 응답 보내기

런칭

라이선스 계약에 서명

프로덕션 환경으로 전환하기

이 기사가 도움이 되었나요?

이 페이지 평가

의견을 보내 주셔서 감사드립니다!