Xsolla-logo
  • 문서화
  • 계정 생성

정기결제 생성Webhook POST

사용자가 정기 결제를 생성하면 엑솔라는 create_subscription 유형이 포함된 웹훅을 웹훅 URL로 전송합니다.

Request
Request Body schema: application/json
notification_type
required
string

알림 유형.

custom_parameters
object

사용자 정의 매개 변수입니다.

object

사용자 정의 프로젝트 설정(개체)입니다.

merchant_id
integer

판매자 ID입니다.

project_id
integer

프로젝트 ID. 이 매개 변수는 관리자 페이지의 프로젝트 이름 옆에서 확인할 수 있습니다.

object

정기결제 세부 정보(오브젝트).

date_create
string

정기결제 생성 날짜입니다. ISO 8601에 따른 날짜 및 시간입니다.

date_next_charge
string

다음 충전 날짜입니다. ISO 8601에 따른 날짜 및 시간입니다.

is_gift
boolean

정기 결제를 선물했는지 여부입니다. 이 매개 변수는 값이 true인 경우에만 전달됩니다.

plan_id
string

요금제 ID(API를 통해 생성된 경우, 외부 ID).

product_id
string

상품 ID(액세스 토큰으로 보낸 경우)입니다.

subscription_id
integer

엑솔라 시스템 내의 정기결제 ID입니다.

tags
Array of strings

플랜 태그.

object

정기결제 평가 기간 데이터와 관련된 값입니다.

type
string

평가 기간 형식(day)입니다.

value
integer

무료체험 기간 길이입니다.

object

사용자 세부 사항(개체)입니다.

id
required
string

사용자 ID.

name
string

사용자 이름.

Responses
204

성공적인 처리 표시를 반환합니다.

400

제공된 정보에 오류가 있는 경우 반환합니다(예: 필수 매개변수 누락, 인증 실패 등).

500

서버에 일시적인 오류가 있음을 표시하려면 돌아가세요.

Request samples
curl -v 'https://your.hostname/your/uri' \
-X POST \
-H 'Accept: application/json' \
-H 'Content-Type: application/json' \
-H 'Authorization: Signature 13342703ccaca5064ad33ba451d800c5e823db8f' \
-d '{
        "notification_type": "create_subscription",
        "settings": {
          "project_id": 18404,
          "merchant_id": 2340
        },
        "user": {
            "id": "1234567",
            "name": "John Smith"
        },
        "subscription": {
            "plan_id": "b5dac9c8",
            "subscription_id": "10",
            "product_id": "Demo Product",
            "date_create": "2014-09-22T19:25:25+04:00",
            "date_next_charge": "2015-01-22T19:25:25+04:00",
            "trial": {
                    "value": 90,
                    "type": "day"
                },
            "is_gift": true
        }
    }'
Response samples
application/json
{
  • "error": {
    }
}