콘텐츠로 건너뛰기

디지털 배포 솔루션 (1.0.0)

개요

디지털 배포 솔루션는새로운 엑솔라 솔루션으로 푸시 결제 기술 및 전자 상거래를 통한 결제를 기반으로 현금과 디지털을 연결하는 것을 목표로 합니다.

이 참조는 API 엔드포인트를 2개의 엑솔라 제품용으로 결합합니다. 인게임 스토어 및 페이 스테이션. 2개의 기준 URL이 있습니다.

  • https://store.xsolla.com/api는 일반, 카탈로그, 장바구니, 주문 그룹용입니다.
  • https://ps.xsolla.com은 알림 그룹용입니다.

카탈로그 그룹의 API 엔드포인트는 권한 부여가 필요하지 않습니다.

장바구니 및 주문 그룹의 연산 작업을 하려면 사용자 토큰 생성을 통해 토큰을 생성해야 합니다.

주의

이 참조는 향후 API 디자인을 나타내며 완전한 기능을 하는 인터페이스가 아닙니다. 현재 카탈로그 및 알림 그룹 엔드포인트만 시도해 보실 수 있습니다. 피드백을 남기고 싶으시면 techdoc@xsolla.com으로 이메일을 보내주십시오.
OpenAPI 설명 다운로드
index.json
index.yaml
언어
서버
Mock server
https://xsolla.redocly.app/_mock/ko/api/digital-distribution-hub/
https://store.xsolla.com/api/

장바구니

작업

게임 키

작업

가상 아이템 및 통화

작업

번들

작업

사용자 토큰

작업

알림

작업

알림 취소

요청

다음과 같은 경우 결제 취소 알림을 보냅니다.

  • 결제가 완료되지 않았습니다.
  • 결제가 환불되었습니다.
본문application/json
payment_idinteger필수
curl -i -X POST \
  https://xsolla.redocly.app/_mock/ko/api/digital-distribution-hub/push-payments/cancel \
  -H 'Content-Type: application/json' \
  -d '{
    "payment_id": 784998479
  }'

응답

확인.

지불 알림

요청

사용자에게 요금을 청구한 후에 이 알림을 보냅니다.

본문application/json
paymentobject필수
payment.​amountnumber필수

결제 금액.

payment.​currencystring

주문 통화. 인게임 재화는 SKU를 사용하며 실질 통화는 세 자리ISO 4217코드를 사용합니다.

payment.​geotype_idinteger필수

엑솔라 측 배포 파트너 ID.

payment.​project_transaction_idstring

게임 개발자측의 거래 ID.

payment.​ps_transaction_idstring

배포 파트너측 거래 ID.

project_idinteger필수

프로젝트 ID.

purchaseobject필수
purchase.​order_idinteger필수

주문 아이디.

userobject필수
user.​emailstring

사용자 이메일 주소.

user.​idstring필수

게임에서 사용하는 고유 사용자 식별자입니다.

user.​phonestring

사용자 전화번호.

user.​ps_account_idstring

배포 파트너측 사용자의 결제 계정 ID.

curl -i -X POST \
  https://xsolla.redocly.app/_mock/ko/api/digital-distribution-hub/push-payments/pay \
  -H 'Content-Type: application/json' \
  -d '{
    "payment": {
      "amount": 10,
      "currency": "USD",
      "geotype_id": 13038,
      "ps_transaction_id": "ps_transaction_id"
    },
    "project_id": 18404,
    "purchase": {
      "order_id": 1334430
    },
    "user": {
      "id": "s.ivanov"
    }
  }'

응답

확인.

본문application/json
payment_idinteger
응답
application/json
{
  "payment_id": 784998484
}

주문

작업