Setting/propertiesnotifyurl - Revision history

Weins at 08:43, 8 September 2021

2021-09-08T08:43:57Z

Weins: 1 revision imported

2021-05-19T01:32:56Z

1 revision imported

Beds24>Markkinchin at 16:33, 22 September 2020

2020-09-22T16:33:17Z

Weins: 1版をインポートしました

2019-03-12T02:20:34Z

1版をインポートしました

Beds24>Markkinchin at 11:35, 28 December 2018

2018-12-28T11:35:47Z

New page

A push notification will be sent to this URL when a new booking, significant booking modification which effects availability or cancellation occurs.

The bookid and status are appended to your url like this example.

https://yoururl.com/yourpage?bookid=12345678&status=new

Possible values for status are: new, modify, cancel

The card CVV and a token to retrieve it from the JSON getCard API function can be included as form url encoded POST data in the body of the push.

The URL can contain template variables which will be exchanged with information from the booking.

Multiple URL's can be notified, enter each additional URL on a new line.

Your server should return an HTTP 200 header to acknowledge receipt of the notify.

If there is no response or a response HTTP code of 400 or higher the notify will be retried after a delay.

← Older revision		Revision as of 08:43, 8 September 2021
Line 22:		Line 22:

	The status values are not synchronous, it is possible the first notification will have status modified or cancel instead of new if the booking has changed to that state before the message sends.		The status values are not synchronous, it is possible the first notification will have status modified or cancel instead of new if the booking has changed to that state before the message sends.
		+
		+
		+
		+
		+	新規予約、予約変更、キャンセルが発生すると、このURLにプッシュ通知（Webhook）が送信されます。
		+
		+	予約IDとステータス（予約状況）は次の例のようにURLに追加されます。
		+
		+	https://yoururl.com/yourpage?bookid=12345678&status=new
		+
		+	ステータスに指定できる値は、new, modify, cancel, messageです。
		+
		+	複数のフィールド（予約情報など）が変更された場合、新規またはキャンセルであっても、modifyが送信される可能性があります。
		+
		+	カードのCVVと、JSON getCard API関数からそれを取得するためのトークンは、フォームURLでエンコードされたPOSTデータとして、プッシュのボディに含めることができます。
		+
		+	URLには、予約の情報と変数を含めることができます。
		+
		+	複数のURLを通知することができます。各追加URLを新しい行に入力してください。
		+	あなたのサーバーは、通知を受け取ったことを確認するためにHTTP 200ヘッダーを返す必要があります。
		+	応答がない場合、またはHTTPコードが400以上の場合、通知は時間をおいて再試行されます。
		+	送信メッセージはキューイングされるため、アクションが発生してから通知が送信されるまでに短い時間がかかることがあります。
		+	ステータス値は同期していません。メッセージが送信される前に予約がその状態に変更された場合、最初の通知が新規ではなくステータス修正またはキャンセルになる可能性があります。

← Older revision	Revision as of 01:32, 19 May 2021
(No difference)

@@ Line 1: / Line 1: @@
-A push notification will be sent to this URL when a new booking, significant booking modification which effects availability or cancellation occurs.
+A push notification (webhook) will be sent to this URL when a new booking, significant booking modification which effects availability or cancellation occurs.
 The bookid and status are appended to your url like this example.
@@ Line 5: / Line 5: @@
 https://yoururl.com/yourpage?bookid=12345678&status=new
-Possible values for status are: new, modify, cancel
+Possible values for status are: new, modify, cancel, message
 The card CVV and a token to retrieve it from the JSON getCard API function can be included as form url encoded POST data in the body of the push.
@@ Line 16: / Line 18: @@
 If there is no response or a response HTTP code of 400 or higher the notify will be retried after a delay.