WEBHOOK SUBSCRIPTIONS ARE LIMITED TO 10 PER PJMID. But a single Webhook can simultaneous track multiple request IDs.
For more information on PayJunction account structures, see the PayJunction Account Structures guide.
Parameters
| required | name | format | description |
|---|---|---|---|
| * | event |
SMARTTERMINAL_REQUEST TRANSACTION TRANSACTION_SIGNATURE CUSTOMER DEPOSIT SETTLEMENT |
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. TRANSACTION is sent on any transaction processed in an account. 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 Request
curl -X POST -u "YOUR_USER:YOUR_PASSWORD" -H "Accept: application/json" -H "X-PJ-Application-Key: c0d73641-65ae-4e9b-bbab-fb6215d7ee98" \ -d "event=TRANSACTION" \ -d "url=https://YOUR-WEBHOOK-URL" \ -d "secret=YOUR-SECRET" \ "https://api.payjunction.com/webhooks"
Example Response
{
"webhookId" : "9b5fda91-1cab-4d31-8950-0439c82e38ab",
"events" : [ "SMARTTERMINAL_REQUEST" ],
"url" : "https://url-that-will-receive-webhooks",
"created" : "2016-04-29T15:53:36Z"
}