Logo
Get supportSee a Demo
HomeAPI Reference
HomeAPI Reference
    • Authentication
  • API Reference
Get supportSee a Demo
API ReferenceTransactions

Get Audit Status

GET
/transactions/audit/:id
GET
/transactions/audit/:id
1curl https://rewards-api.getkard.com/transactions/audit/%7Bid%7D \
2     -H "Authorization: Bearer <token>"
Try it
1{
2  "_id": "5eb2d4a39ce24e00081488c4",
3  "transactionId": "some cardlinked transaction id",
4  "auditCode": 8001,
5  "merchantName": "Caribbean Goodness",
6  "auditDescription": "duplicate",
7  "preferredContactEmail": "someone@company.com",
8  "status": "NEW",
9  "transactionAmountInCents": 2600,
10  "referringPartnerUserId": "5e135a5a2b1f4c0008c9df79",
11  "merchantId": "5e27318c9b346f00087fbb32",
12  "submitterName": "Submitter Name",
13  "resolutionCode": 5001,
14  "resolutionDescription": "duplicate",
15  "resolutionTimeStamp": "2022-09-15T19:03:26.236Z"
16}
Call this endpoint to retrieve an update on the status of a created transaction audit. Note, the resolutionCode, resolutionDescription and resolutionTimeStamp will not be available until the audit has a “CLOSED” status signifying its resolution. <br/> <b>Required scopes:</b> `audit:read`
Was this page helpful?
Previous

Create User

Next
Built with
Create User

Call this endpoint to retrieve an update on the status of a created transaction audit. Note, the resolutionCode, resolutionDescription and resolutionTimeStamp will not be available until the audit has a “CLOSED” status signifying its resolution.
Required scopes: audit:read

Authentication

AuthorizationBearer
Bearer authentication of the form `Bearer <token>`, where token is your auth token.

Path parameters

idstringRequired
The audit ID provided by Kard's system

Response

This endpoint returns an object.
_idstring
The audit ID provided by Kard's system
transactionIdstring
Transaction ID associated with audit
auditCodeinteger
Audit Code - Enum. Code to define audit. <ul> <li>`3005` : Customer is claiming cashback is incorrect - INCORRECT CASHBACK CLAIM</li> <li>`3006` : Transaction is missing the cashback award - MISSING CASHBACK AWARD</li> <li>`8001` : Other - check audit description</li> </ul>
merchantNamestring
Merchant name related to the transaction audit
auditDescriptionstring
Audit Description. More details around the audit
preferredContactEmailstring
Preferred contact email to message to as audit is reviewed
statusenum
Status of audit
Allowed values:
transactionAmountInCentsinteger or null
Transaction amount in cents
referringPartnerUserIdstring or null
Referring partner user ID associated with the transaction to audit
merchantIdstring or null
Related merchant ID in Kard's system associated to the transaction audit
submitterNamestring or null
Submitter name
resolutionCodeinteger or null
Resolution Code - Enum. field is available when audit is status CLOSED. <ul> <li>`5001` : Transaction will be deleted</li> <li>`5002` : Settlement amount will be adjusted</li> <li>`5003` : Return amount will be adjusted</li> <li>`5004` : Reward dispute resolved</li> <li>`5005` : Transaction will be marked for writeoff</li> <li>`5006` : Transaction will be marked as rejected</li> <li>`5007` : Transaction will be resent through webhook</li> <li>`5008` : Transaction will be resent through daily file</li> <li>`5009` : No change needed</li> <li>`9001` : Ineligible item in purchase</li> <li>`9002` : Return was made</li> <li>`9003` : User ineligible for offer (usually because of participation through another program)</li> <li>`9004` : Redemption limit hit (if offer has a set number of redemptions and it isn't handled programmatically)</li> <li>`9005` : Transaction not captured</li> </ul>
resolutionDescriptionstring or null

Resolution Description; field is available when audit is status CLOSED

resolutionTimeStampdatetime or null

Resolution timestamp of when the audit was marked as status CLOSED in ISO format; available when audit is closed.

Errors

Audit Code - Enum. Code to define audit.

  • 3005 : Customer is claiming cashback is incorrect - INCORRECT CASHBACK CLAIM
  • 3006 : Transaction is missing the cashback award - MISSING CASHBACK AWARD
  • 8001 : Other - check audit description

Resolution Code - Enum. field is available when audit is status CLOSED.

  • 5001 : Transaction will be deleted
  • 5002 : Settlement amount will be adjusted
  • 5003 : Return amount will be adjusted
  • 5004 : Reward dispute resolved
  • 5005 : Transaction will be marked for writeoff
  • 5006 : Transaction will be marked as rejected
  • 5007 : Transaction will be resent through webhook
  • 5008 : Transaction will be resent through daily file
  • 5009 : No change needed
  • 9001 : Ineligible item in purchase
  • 9002 : Return was made
  • 9003 : User ineligible for offer (usually because of participation through another program)
  • 9004 : Redemption limit hit (if offer has a set number of redemptions and it isn’t handled programmatically)
  • 9005 : Transaction not captured

Bearer authentication of the form Bearer <token>, where token is your auth token.