WEBHOOK SUBSCRIPTIONS ARE LIMITED TO 5 PER PJMID. But a single Webhook can simultaneous track multiple requestI IDs.
For more information on PayJunction account structures, see the PayJunction Account Structures guide.
Provides detailed status information for payment requests to the PayJunction Smart Terminal.
Transaction requests (/request-payment) will return the reference id as a requestPaymentId while all other requests such as signature capture (/request-signature) will return the reference id as a requestId. Regardless of the original request type, the SMARTTERMINAL_REQUEST webhook data object will always reference this id as the requestId.
Example Flow
Connecting
Connection with the specified Smart Terminal is still pending
{ "created": "2018-02-20T20:30:01.756Z", "data": { "requestId": "a178db80-59e3-4e39-a6c7-bf8bab7ebb28", "status": "CONNECTING" }, "id": "835a3fe6-a7e2-4872-9206-1ed28c4476e6", "type": "SMARTTERMINAL_REQUEST" }
Busy Terminal
{ "created": "2018-02-22T17:58:03.744Z", "data": { "requestId": "ca6a9797-3247-4f1e-9dcb-e053f31f8bb3", "status": "BUSY" }, "id": "d50219c3-12f5-4bfe-98bd-d7cca3ac4e14a9", "type": "SMARTTERMINAL_REQUEST" }
Connected, Now in Progress
Smart Terminal is performing the requested action.
{ "created": "2018-02-20T20:30:02.436Z", "data": { "requestId": "a178db80-59e3-4e39-a6c7-bf8bab44bb28", "status": "IN_PROGRESS" }, "id": "c3a0e26f-87f7-46ef-9b0e-15ebbd7e3478", "type": "SMARTTERMINAL_REQUEST" }
Transaction Completed
Transaction Request - Complete
{ "created": "2018-02-20T20:30:07.235Z", "data": { "requestId": "a178db80-59e3-4e39-a6c7-bf8bab7ebb28", "status": "COMPLETE", "transactionId": 10082 }, "id": "762611cc-1636-434e-b137-8b148cf249a7", "type": "SMARTTERMINAL_REQUEST" }
Transaction Request - Canceled
If the transaction is not processed (canceled, timeout, etc), transactionId field will not be present.
{ "created": "2018-02-20T20:30:07.235Z", "data": { "requestId": "a178db80-59e3-4e39-a6c7-bf8bab7ebb28", "status": "COMPLETE", }, "id": "762611cc-1636-434e-b137-8b148cf249a7", "type": "SMARTTERMINAL_REQUEST" }
Smart Terminal Request Input - Complete
{ "id" : "2b90ff33-e2b6-45c4-810f-6226748d8cee", "created" : "2022-04-26T16:27:24.398Z", "type" : "SMARTTERMINAL_REQUEST", "data" : { "requestId" : "c0e35e31-ae9e-40c2-969f-f92bcbfb4793", "inputValue" : "8006010230", "status" : "COMPLETE" } }
Smart Terminal Request Prompt - Complete
{ "id" : "7afa93f1-2bad-47df-afbe-949fc9c53a09", "created" : "2020-10-20T22:07:39.098Z", "type" : "SMARTTERMINAL_REQUEST", "data" : { "requestId" : "77083e4d-0ffe-4be6-b510-79e6da83e99f", "promptButton" : "Yes", "status" : "COMPLETE" } }
Signature Capture Request - Complete
Notice that transaction requests will return a transactionId while signature capture requests return a signatureId.
{ "created": "2018-09-04T20:30:07.235Z", "data": { "requestId": "1c1a2db0-4bb5-4f60-96ce-1a66222e5276", "status": "COMPLETE", "signatureId": "bc84d60dedcd4896918a07a82e76ccb1" }, "id": "762611cc-1636-434e-b137-8b148cf249a7", "type": "SMARTTERMINAL_REQUEST" }