Follow

POST /webhooks

WEBHOOK SUBSCRIPTIONS ARE LIMITED TO 5 PER PJMID
For more information on PayJunction account structures, see the PayJunction Account Structures guide.

Parameters

required name format description
* event

SMARTTERMINAL_REQUEST

SMARTTERMINAL_TRANSACTION

TRANSACTION_SIGNATURE

The webhook events that will be posted. 

SMARTTERMINAL_REQUEST is sent when the status changes for a Smart Terminal payment request and offers greater insight into the current state of the transaction.

SMARTTERMINAL_TRANSACTION is sent on any completed Smart Terminal transaction.

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 must be HTTPS with max length 255 and cannot contain a port.

The URL that webhook events will be posted to.

For testing and initial development, HTTP URLs from http://requestcatcher.com/ can be used.

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

Example Response

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