searchTransactions
ApiScope: payment.transaction.list
API Scope Level: DealerScope
Path Parameters
dealerUuid string required
application/json
Request Body required
userDetail object
fromDate date-time
toDate date-time
tenderFilter object
filterUnSettled boolean
transactionStatus string[]
Possible values: [SUCCESSFUL
, FAILED
]
invoiceGuids string[]
orderUuids string[]
customerUuids string[]
departmentUuids string[]
paginationParams object
sortParams object
Responses
- 200
OK
application/json
Schema
Example (from schema)
Schema
errors object[]
warnings object[]
successfulTransactions object[]
failedTransactions object[]
successfulTransactionsCount int64
failedTransactionsCount int64
{
"errors": [
{
"errorCode": 0,
"errorTitle": "string",
"errorMessage": "string",
"errorDescription": "string"
}
],
"warnings": [
{
"warningCode": 0,
"warningTitle": "string",
"warningMessage": "string",
"warningDescription": "string"
}
],
"successfulTransactions": [
{
"status": "APPROVED",
"id": 0,
"uuid": "string",
"paymentGatewayResponse": {
"id": 0,
"version": 0,
"responseCode": 0,
"responseReasonCode": 0,
"responseReasonText": "string",
"authorizationCode": "string",
"avsresponse": "string",
"description": "string",
"amount": 0,
"cardCodeResponse": "string",
"cardholderAuthenticationVerificationResponse": "string",
"cardType": "string",
"pgtransId": "string",
"pgtransRefId": "string",
"isApproved": true,
"isDeclined": true,
"isError": true,
"isReview": true,
"paymentProviderType": "string",
"uuid": "string",
"paymentAttemptUuid": "string"
},
"paymentUser": {
"id": 0,
"dealerAssociateUUID": "string",
"userUUID": "string",
"dealerDepartmentUUID": "string"
},
"transactionType": "CHARGE",
"invoice": {
"id": 0,
"guid": "string",
"invoiceStatus": "string",
"amount": 0,
"invoiceDate": "2025-03-28T11:34:46.592Z",
"description": "string",
"refundedAmount": 0,
"paidDate": "2025-03-28T11:34:46.592Z",
"fileName": "string",
"reminderMileage": 0,
"reminderDate": "2025-03-28T11:34:46.592Z",
"signatureFileName": "string",
"paymentDeclines": "string",
"invoiceAttributes": {},
"paymentDealer": {
"dealerUuid": "string"
},
"paymentDealerOrder": {
"orderNumber": "string",
"orderType": "string",
"departmentUuid": "string",
"dealerOrderUuid": "string"
},
"paymentCustomer": {
"customerUuid": "string"
},
"paymentUser": {
"id": 0,
"dealerAssociateUUID": "string",
"userUUID": "string",
"dealerDepartmentUUID": "string"
}
},
"tenderData": {
"id": 0,
"data": "string",
"hash": "string",
"tenderSubType": {
"id": 0,
"subTenderName": "string",
"tenderType": {
"id": 0,
"version": 0,
"tenderName": "string",
"availableOnMobile": true
},
"valid": true
}
},
"description": "string",
"transDate": "2025-03-28T11:34:46.592Z",
"transAmount": 0,
"source": "string",
"paymentProvider": "string",
"paymentDealer": {
"dealerUuid": "string",
"name": "string"
},
"paymentDealerOrder": {
"orderNumber": "string",
"orderType": "string",
"orderDate": "2025-03-28T11:34:46.592Z",
"paymentDealer": {
"dealerUuid": "string",
"name": "string"
},
"paymentCustomer": {
"customerUuid": "string",
"firstName": "string",
"middleName": "string",
"lastName": "string",
"company": "string"
},
"paymentUser": {
"id": 0,
"dealerAssociateUUID": "string",
"userUUID": "string",
"dealerDepartmentUUID": "string"
},
"signatureRequestId": 0,
"departmentUuid": "string",
"dealerOrderUuid": "string",
"numberOfInvoices": 0,
"readyROData": "string",
"paidAmount": 0,
"amount": 0,
"dealerOrderSyncDate": "2025-03-28T11:34:46.592Z",
"paidInKaarma": true,
"suspicious": true,
"paid": true,
"paymentRequestSent": true,
"paidOnline": true
},
"paymentCustomer": {
"customerUuid": "string",
"firstName": "string",
"middleName": "string",
"lastName": "string",
"company": "string"
},
"deviceType": "MANUAL",
"transactionAttributes": {},
"accountBalance": 0,
"details": "string",
"isSettled": true,
"settledDate": "2025-03-28T11:34:46.592Z",
"paymentGatewayTransId": "string",
"isVoided": true,
"ipAddress": "string",
"parentTransaction": {
"id": 0,
"transactionType": {
"id": 0,
"shortCode": "string",
"description": "string",
"deposit": 0,
"fee": 0
},
"description": "string",
"transDate": "2025-03-28T11:34:46.592Z",
"transAmount": 0,
"accountBalance": 0,
"transRefNum": "string",
"details": "string",
"category": "string",
"source": "string",
"isReconciled": true,
"isSettled": true,
"reconciledDate": "2025-03-28T11:34:46.592Z",
"settledDate": "2025-03-28T11:34:46.592Z",
"deviceId": 0,
"paymentGatewayTransId": "string",
"isVoided": true,
"paymentProvider": "string",
"uuid": "string"
},
"transactionDetails": [
{
"id": 0,
"transactionId": 0,
"transactionIncompleteId": 0,
"type": "string",
"amount": 0,
"description": "string"
}
],
"roOwner": {
"id": 0,
"uuid": "string",
"userUuid": "string",
"firstName": "string",
"lastName": "string",
"userName": "string",
"cellPhone": "string",
"textNumber": "string",
"isTextNumberVerified": true,
"emailAddress": "string",
"nickname": "string",
"associateDmsID": "string",
"imageUrl": "string",
"isValid": true,
"bio": "string",
"userInviteStatus": "string",
"defaultThreadOwnerUserUUID": "string",
"outOfOffice": true,
"outOfOfficeStartDate": "string",
"ssoFeatureEnabled": true,
"isDealerMappedToSsoPartner": true,
"isSsoPartnerMapped": true,
"department": {
"id": 0,
"name": "string",
"uuid": "string",
"calendarUuid": "string",
"brokerNumber": "string",
"communicationGroup": "string",
"dealer": {
"id": 0,
"name": "string",
"uuid": "string",
"isValid": true
}
},
"role": {
"roleName": "string",
"roleAcronym": "string"
}
},
"cashier": {
"id": 0,
"uuid": "string",
"userUuid": "string",
"firstName": "string",
"lastName": "string",
"userName": "string",
"cellPhone": "string",
"textNumber": "string",
"isTextNumberVerified": true,
"emailAddress": "string",
"nickname": "string",
"associateDmsID": "string",
"imageUrl": "string",
"isValid": true,
"bio": "string",
"userInviteStatus": "string",
"defaultThreadOwnerUserUUID": "string",
"outOfOffice": true,
"outOfOfficeStartDate": "string",
"ssoFeatureEnabled": true,
"isDealerMappedToSsoPartner": true,
"isSsoPartnerMapped": true,
"department": {
"id": 0,
"name": "string",
"uuid": "string",
"calendarUuid": "string",
"brokerNumber": "string",
"communicationGroup": "string",
"dealer": {
"id": 0,
"name": "string",
"uuid": "string",
"isValid": true
}
},
"role": {
"roleName": "string",
"roleAcronym": "string"
}
},
"threeDSAuthenticationFailed": true
}
],
"failedTransactions": [
{
"status": "APPROVED",
"id": 0,
"uuid": "string",
"paymentGatewayResponse": {
"id": 0,
"version": 0,
"responseCode": 0,
"responseReasonCode": 0,
"responseReasonText": "string",
"authorizationCode": "string",
"avsresponse": "string",
"description": "string",
"amount": 0,
"cardCodeResponse": "string",
"cardholderAuthenticationVerificationResponse": "string",
"cardType": "string",
"pgtransId": "string",
"pgtransRefId": "string",
"isApproved": true,
"isDeclined": true,
"isError": true,
"isReview": true,
"paymentProviderType": "string",
"uuid": "string",
"paymentAttemptUuid": "string"
},
"paymentUser": {
"id": 0,
"dealerAssociateUUID": "string",
"userUUID": "string",
"dealerDepartmentUUID": "string"
},
"transactionType": "CHARGE",
"invoice": {
"id": 0,
"guid": "string",
"invoiceStatus": "string",
"amount": 0,
"invoiceDate": "2025-03-28T11:34:46.593Z",
"description": "string",
"refundedAmount": 0,
"paidDate": "2025-03-28T11:34:46.593Z",
"fileName": "string",
"reminderMileage": 0,
"reminderDate": "2025-03-28T11:34:46.593Z",
"signatureFileName": "string",
"paymentDeclines": "string",
"invoiceAttributes": {},
"paymentDealer": {
"dealerUuid": "string"
},
"paymentDealerOrder": {
"orderNumber": "string",
"orderType": "string",
"departmentUuid": "string",
"dealerOrderUuid": "string"
},
"paymentCustomer": {
"customerUuid": "string"
},
"paymentUser": {
"id": 0,
"dealerAssociateUUID": "string",
"userUUID": "string",
"dealerDepartmentUUID": "string"
}
},
"tenderData": {
"id": 0,
"data": "string",
"hash": "string",
"tenderSubType": {
"id": 0,
"subTenderName": "string",
"tenderType": {
"id": 0,
"version": 0,
"tenderName": "string",
"availableOnMobile": true
},
"valid": true
}
},
"description": "string",
"transDate": "2025-03-28T11:34:46.593Z",
"transAmount": 0,
"source": "string",
"paymentProvider": "string",
"paymentDealer": {
"dealerUuid": "string",
"name": "string"
},
"paymentDealerOrder": {
"orderNumber": "string",
"orderType": "string",
"orderDate": "2025-03-28T11:34:46.593Z",
"paymentDealer": {
"dealerUuid": "string",
"name": "string"
},
"paymentCustomer": {
"customerUuid": "string",
"firstName": "string",
"middleName": "string",
"lastName": "string",
"company": "string"
},
"paymentUser": {
"id": 0,
"dealerAssociateUUID": "string",
"userUUID": "string",
"dealerDepartmentUUID": "string"
},
"signatureRequestId": 0,
"departmentUuid": "string",
"dealerOrderUuid": "string",
"numberOfInvoices": 0,
"readyROData": "string",
"paidAmount": 0,
"amount": 0,
"dealerOrderSyncDate": "2025-03-28T11:34:46.593Z",
"paidInKaarma": true,
"suspicious": true,
"paid": true,
"paymentRequestSent": true,
"paidOnline": true
},
"paymentCustomer": {
"customerUuid": "string",
"firstName": "string",
"middleName": "string",
"lastName": "string",
"company": "string"
},
"deviceType": "MANUAL",
"transactionAttributes": {},
"accountBalance": 0,
"details": "string",
"isSettled": true,
"settledDate": "2025-03-28T11:34:46.593Z",
"paymentGatewayTransId": "string",
"isVoided": true,
"ipAddress": "string",
"parentTransaction": {
"id": 0,
"transactionType": {
"id": 0,
"shortCode": "string",
"description": "string",
"deposit": 0,
"fee": 0
},
"description": "string",
"transDate": "2025-03-28T11:34:46.593Z",
"transAmount": 0,
"accountBalance": 0,
"transRefNum": "string",
"details": "string",
"category": "string",
"source": "string",
"isReconciled": true,
"isSettled": true,
"reconciledDate": "2025-03-28T11:34:46.593Z",
"settledDate": "2025-03-28T11:34:46.593Z",
"deviceId": 0,
"paymentGatewayTransId": "string",
"isVoided": true,
"paymentProvider": "string",
"uuid": "string"
},
"transactionDetails": [
{
"id": 0,
"transactionId": 0,
"transactionIncompleteId": 0,
"type": "string",
"amount": 0,
"description": "string"
}
],
"roOwner": {
"id": 0,
"uuid": "string",
"userUuid": "string",
"firstName": "string",
"lastName": "string",
"userName": "string",
"cellPhone": "string",
"textNumber": "string",
"isTextNumberVerified": true,
"emailAddress": "string",
"nickname": "string",
"associateDmsID": "string",
"imageUrl": "string",
"isValid": true,
"bio": "string",
"userInviteStatus": "string",
"defaultThreadOwnerUserUUID": "string",
"outOfOffice": true,
"outOfOfficeStartDate": "string",
"ssoFeatureEnabled": true,
"isDealerMappedToSsoPartner": true,
"isSsoPartnerMapped": true,
"department": {
"id": 0,
"name": "string",
"uuid": "string",
"calendarUuid": "string",
"brokerNumber": "string",
"communicationGroup": "string",
"dealer": {
"id": 0,
"name": "string",
"uuid": "string",
"isValid": true
}
},
"role": {
"roleName": "string",
"roleAcronym": "string"
}
},
"cashier": {
"id": 0,
"uuid": "string",
"userUuid": "string",
"firstName": "string",
"lastName": "string",
"userName": "string",
"cellPhone": "string",
"textNumber": "string",
"isTextNumberVerified": true,
"emailAddress": "string",
"nickname": "string",
"associateDmsID": "string",
"imageUrl": "string",
"isValid": true,
"bio": "string",
"userInviteStatus": "string",
"defaultThreadOwnerUserUUID": "string",
"outOfOffice": true,
"outOfOfficeStartDate": "string",
"ssoFeatureEnabled": true,
"isDealerMappedToSsoPartner": true,
"isSsoPartnerMapped": true,
"department": {
"id": 0,
"name": "string",
"uuid": "string",
"calendarUuid": "string",
"brokerNumber": "string",
"communicationGroup": "string",
"dealer": {
"id": 0,
"name": "string",
"uuid": "string",
"isValid": true
}
},
"role": {
"roleName": "string",
"roleAcronym": "string"
}
},
"threeDSAuthenticationFailed": true
}
],
"successfulTransactionsCount": 0,
"failedTransactionsCount": 0
}
POST /v4/dealers/:dealerUuid/transactions/searches
Authorization
name: basicAuthtype: httpscheme: basic
Request
Request
curl / cURL
curl -L -X POST '/payment/v4/dealers/:dealerUuid/transactions/searches' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
--data-raw '{
"userDetail": {
"dealerAssociateUUID": "string",
"userUUID": "string",
"departmentUUID": "string"
},
"fromDate": "2025-03-28T11:34:46.511Z",
"toDate": "2025-03-28T11:34:46.511Z",
"tenderFilter": {
"subTenderName": "string",
"tenderName": "string"
},
"filterUnSettled": true,
"transactionStatus": [
"SUCCESSFUL"
],
"invoiceGuids": [
"string"
],
"orderUuids": [
"string"
],
"customerUuids": [
"string"
],
"departmentUuids": [
"string"
],
"paginationParams": {
"perPage": 0,
"page": 0
},
"sortParams": {
"sortOrder": "ASC",
"sortKey": "ID"
}
}'
python / requests
curl -L -X POST '/payment/v4/dealers/:dealerUuid/transactions/searches' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
--data-raw '{
"userDetail": {
"dealerAssociateUUID": "string",
"userUUID": "string",
"departmentUUID": "string"
},
"fromDate": "2025-03-28T11:34:46.511Z",
"toDate": "2025-03-28T11:34:46.511Z",
"tenderFilter": {
"subTenderName": "string",
"tenderName": "string"
},
"filterUnSettled": true,
"transactionStatus": [
"SUCCESSFUL"
],
"invoiceGuids": [
"string"
],
"orderUuids": [
"string"
],
"customerUuids": [
"string"
],
"departmentUuids": [
"string"
],
"paginationParams": {
"perPage": 0,
"page": 0
},
"sortParams": {
"sortOrder": "ASC",
"sortKey": "ID"
}
}'
go / native
curl -L -X POST '/payment/v4/dealers/:dealerUuid/transactions/searches' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
--data-raw '{
"userDetail": {
"dealerAssociateUUID": "string",
"userUUID": "string",
"departmentUUID": "string"
},
"fromDate": "2025-03-28T11:34:46.511Z",
"toDate": "2025-03-28T11:34:46.511Z",
"tenderFilter": {
"subTenderName": "string",
"tenderName": "string"
},
"filterUnSettled": true,
"transactionStatus": [
"SUCCESSFUL"
],
"invoiceGuids": [
"string"
],
"orderUuids": [
"string"
],
"customerUuids": [
"string"
],
"departmentUuids": [
"string"
],
"paginationParams": {
"perPage": 0,
"page": 0
},
"sortParams": {
"sortOrder": "ASC",
"sortKey": "ID"
}
}'
nodejs / axios
curl -L -X POST '/payment/v4/dealers/:dealerUuid/transactions/searches' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
--data-raw '{
"userDetail": {
"dealerAssociateUUID": "string",
"userUUID": "string",
"departmentUUID": "string"
},
"fromDate": "2025-03-28T11:34:46.511Z",
"toDate": "2025-03-28T11:34:46.511Z",
"tenderFilter": {
"subTenderName": "string",
"tenderName": "string"
},
"filterUnSettled": true,
"transactionStatus": [
"SUCCESSFUL"
],
"invoiceGuids": [
"string"
],
"orderUuids": [
"string"
],
"customerUuids": [
"string"
],
"departmentUuids": [
"string"
],
"paginationParams": {
"perPage": 0,
"page": 0
},
"sortParams": {
"sortOrder": "ASC",
"sortKey": "ID"
}
}'
ruby / Net::HTTP
curl -L -X POST '/payment/v4/dealers/:dealerUuid/transactions/searches' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
--data-raw '{
"userDetail": {
"dealerAssociateUUID": "string",
"userUUID": "string",
"departmentUUID": "string"
},
"fromDate": "2025-03-28T11:34:46.511Z",
"toDate": "2025-03-28T11:34:46.511Z",
"tenderFilter": {
"subTenderName": "string",
"tenderName": "string"
},
"filterUnSettled": true,
"transactionStatus": [
"SUCCESSFUL"
],
"invoiceGuids": [
"string"
],
"orderUuids": [
"string"
],
"customerUuids": [
"string"
],
"departmentUuids": [
"string"
],
"paginationParams": {
"perPage": 0,
"page": 0
},
"sortParams": {
"sortOrder": "ASC",
"sortKey": "ID"
}
}'
csharp / RestSharp
curl -L -X POST '/payment/v4/dealers/:dealerUuid/transactions/searches' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
--data-raw '{
"userDetail": {
"dealerAssociateUUID": "string",
"userUUID": "string",
"departmentUUID": "string"
},
"fromDate": "2025-03-28T11:34:46.511Z",
"toDate": "2025-03-28T11:34:46.511Z",
"tenderFilter": {
"subTenderName": "string",
"tenderName": "string"
},
"filterUnSettled": true,
"transactionStatus": [
"SUCCESSFUL"
],
"invoiceGuids": [
"string"
],
"orderUuids": [
"string"
],
"customerUuids": [
"string"
],
"departmentUuids": [
"string"
],
"paginationParams": {
"perPage": 0,
"page": 0
},
"sortParams": {
"sortOrder": "ASC",
"sortKey": "ID"
}
}'
php / cURL
curl -L -X POST '/payment/v4/dealers/:dealerUuid/transactions/searches' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
--data-raw '{
"userDetail": {
"dealerAssociateUUID": "string",
"userUUID": "string",
"departmentUUID": "string"
},
"fromDate": "2025-03-28T11:34:46.511Z",
"toDate": "2025-03-28T11:34:46.511Z",
"tenderFilter": {
"subTenderName": "string",
"tenderName": "string"
},
"filterUnSettled": true,
"transactionStatus": [
"SUCCESSFUL"
],
"invoiceGuids": [
"string"
],
"orderUuids": [
"string"
],
"customerUuids": [
"string"
],
"departmentUuids": [
"string"
],
"paginationParams": {
"perPage": 0,
"page": 0
},
"sortParams": {
"sortOrder": "ASC",
"sortKey": "ID"
}
}'
java / OkHttp
curl -L -X POST '/payment/v4/dealers/:dealerUuid/transactions/searches' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
--data-raw '{
"userDetail": {
"dealerAssociateUUID": "string",
"userUUID": "string",
"departmentUUID": "string"
},
"fromDate": "2025-03-28T11:34:46.511Z",
"toDate": "2025-03-28T11:34:46.511Z",
"tenderFilter": {
"subTenderName": "string",
"tenderName": "string"
},
"filterUnSettled": true,
"transactionStatus": [
"SUCCESSFUL"
],
"invoiceGuids": [
"string"
],
"orderUuids": [
"string"
],
"customerUuids": [
"string"
],
"departmentUuids": [
"string"
],
"paginationParams": {
"perPage": 0,
"page": 0
},
"sortParams": {
"sortOrder": "ASC",
"sortKey": "ID"
}
}'
powershell / RestMethod
curl -L -X POST '/payment/v4/dealers/:dealerUuid/transactions/searches' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
--data-raw '{
"userDetail": {
"dealerAssociateUUID": "string",
"userUUID": "string",
"departmentUUID": "string"
},
"fromDate": "2025-03-28T11:34:46.511Z",
"toDate": "2025-03-28T11:34:46.511Z",
"tenderFilter": {
"subTenderName": "string",
"tenderName": "string"
},
"filterUnSettled": true,
"transactionStatus": [
"SUCCESSFUL"
],
"invoiceGuids": [
"string"
],
"orderUuids": [
"string"
],
"customerUuids": [
"string"
],
"departmentUuids": [
"string"
],
"paginationParams": {
"perPage": 0,
"page": 0
},
"sortParams": {
"sortOrder": "ASC",
"sortKey": "ID"
}
}'