POST /webhooks

Add a webhook. Limit 5 webhook subscriptions per PJMID. For more information on PayJunction account structures please see the PayJunction Account Structures section of the getting started guide.


required name format description
* event



The webhook events that will be posted. SMARTTERMINAL_TRANSACTION is sent on any completed transaction performed via the Smart Terminal. TRANSACTION_SIGNATURE is sent whenever a transaction is signed. Both will be received regardless of whether the transaction was initiated via the API or another service.
* url Text, URL with max length 255. URL cannot contain a port and must be HTTPS.

The URL that webhook events will be posted to.

For testing and initial development, HTTP URLs from can be used.

  secret Text, max length 255. If set, All webhooks sent will include a "X-Pj-Signature" header with the post. The value of the header is a HMAC hash of the entire json payload using the SHA 256 algorithm, using the secret as the secret key.

Example Response

	"webhookId" : "9b5fda91-1cab-4d31-8950-0439c82e38ab",
	"url" : "https://url-that-will-receive-webhooks",
	"created" : "2016-04-29T15:53:36Z"