The status query parameter is now supported when searching for transactions. This is particularly useful for finding ACH transaction rejects in an account.
For more information on processing ACH transactions and handling rejects, see our ACH Check Transactions tutorial.
Search for previously processed transactions based on supplied parameters.
Search parameters
name | format | description |
---|---|---|
status |
|
List transactions by posture status. Useful for finding ACH reject transactions. |
action |
|
Search for transactions by action. |
billingFirstName | Max Length 16 | Billing first name. |
billingLastName | Max Length 32 | Billing last name. |
lastFour |
4 digits Integer | Last 4 digits of the Card or ACH |
settlementId | Valid Integer | List transactions by settlementId. To list all unsettled transactions, set settlementId to 0. |
terminalId | Valid Integer | List transactions by terminalId. Note: Not to be confused with smartTerminalId. |
scheduleId | Valid Integer | List transactions by scheduleId from a recurring schedule. |
invoiceNumber | Max Length 32 | Search for transactions by a specific invoiceNumber. |
purchaseOrderNumber | Max Length 32 | Search for transactions by a specific purchaseOrderNumber. |
amountTotal | Valid transaction amount | Search for transactions by a specific transaction amount. |
service |
|
Search for transactions by service. For additional details please see: "Available Results for 'service' Response" |
startDate | ISO 8601 formatted datetime string with time zone included, either 'Z' or time offset. Examples: 2021-04-01T13:05:06Z 2021-04-01T13:05:06-05:00 |
Search for transactions starting from a certain date and time. Can be used independently or in conjunction with endDate. |
endDate | ISO 8601 formatted datetime string with time zone included, either 'Z' or time offset. Examples: 2021-04-01T13:05:06Z 2021-04-01T13:05:06-05:00 |
Search for transactions up to a certain date and time. Can be used independently or in conjunction with startDate. |
Paging Parameters
name | format | description |
---|---|---|
limit | Max 50 | Limits the number of results per page. See Pagination. |
offset | Max 2^31 |
The index at which to start returning results. |
Example Request
curl https://api.payjunction.com/transactions?settlementId=0&terminalId=9&limit=1&startDate=2021-02-12T21:45:01Z&endDate=2021-02-12T21:47:00Z \ -u "login:password" \ -H "Accept: application/json" \ -H "X-PJ-Application-Key: YOUR_PRODUCTION_APP_KEY"
Response
API version 2023-05-16 or above required to receive the surcharge object and fields in transaction response details. See how to use API versions here.
Click here for more information regarding surcharge.
Successful Search Response
{ "next" : "https://api.payjunction.com/transactions?settlementId=0&terminalId=9&amountTotal=5.00&offset=1&limit=1", "results" : [ { "transactionId" : 171927, "uri" : "https://api.payjunction.com/transactions/171927", "terminalId" : 10000, "action" : "CHARGE", "amountBase" : "1.11", "amountTax" : "3.00", "amountShipping" : "1.00", "amountTip" : "2.00", "amountSurcharge" : "0.21", "amountTotal" : "7.32", "surcharge" : { "percentage" : 3.00000, "status" : "APPLIED" }, "method" : "KEYED",
"service": "VIRTUAL_TERMINAL",
"status" : "CAPTURE", "created" : "2021-02-12T21:46:01Z", "lastModified" : "2021-02-15T23:00:27Z", "response" : { "approved" : true, "code" : "00", "message" : "Approved", "processor" : { "authorized" : true, "approvalCode" : "PJ20AP" } }, "settlement" : { "settled" : false }, "vault" : { "type" : "CARD", "accountType" : "VISA", "lastFour" : "1111" }, "billing" : { "email" : "jdoe@example.com" } } ] }
Validation Error
The following query parameters will return validation errors if the values are unrecognized or formatted incorrectly:
- amountTotal
- startDate
- endDate
- status
{ "errors" : [ { "message" : "This field is invalid.", "parameter" : "status", "type" : "invalid" } ] }