Receive Terminal Activity Data Ready.

post

https://partner.example.com/webhooks/terminal-activity-data

Expected merchant webhook endpoint for Maya TERMINAL_ACTIVITY_DATA_READY events.

Maya sends this POST when encrypted terminal activity data is available for download. Verify authenticity using X-Maya-Webhook-Signature and X-Maya-Webhook-Timestamp (see Webhook Security on developers.maya.ph), deduplicate with Idempotency-Key / id, acknowledge with any 2xx, then download, decrypt, and verify the file checksum asynchronously.

Body Params

Compact JSON webhook event for terminal activity data ready notifications. Contains metadata and a short-lived download pointer only; it does not include the full terminal array.

uuid

required

Maya-generated unique identifier for this webhook event. This value also maps to the Idempotency-Key header.

type

string

enum

required

Registered Maya event type for the terminal activity data ready notification. Expected value: TERMINAL_ACTIVITY_DATA_READY.

Allowed:

time

date-time

required

ISO-8601 timestamp for when the webhook event was emitted.

data

object

required

Headers

Idempotency-Key

uuid

required

Same value as id in the webhook body. Use to deduplicate retries and repeated deliveries.

X-Maya-Webhook-Signature

string

required

Maya-generated webhook signature. Verify authenticity before processing the payload.

X-Maya-Webhook-Timestamp

string

required

Unix timestamp in milliseconds at send time. Use to reject stale or replayed deliveries.

Responses

200

Webhook accepted. Any 2xx response is treated as successful delivery. Keep handling asynchronous; do not parse the terminal activity data file synchronously in the request path.

400

Client error. Treated as a failed delivery; Maya retries non-2xx responses for up to 1 hour.

401

Unauthorized. Treated as a failed delivery; Maya retries non-2xx responses for up to 1 hour.

500

Merchant processing failure. Maya retries non-2xx responses using exponential backoff for up to 1 hour.

Language

Loading…