정기결제 생성

Xsolla Developers

또는

관리자 페이지로

정기결제 생성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
PHP
HTTP

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": {"code": "INCORRECT_AMOUNT",
"message": "Incorrect amount"
}
}