API Reconciliation

From time to time, a Lender may need to make a reconciliation. Cashcat provides API for reconciliation, you can use it to sync information in your database with information from the Cashcat backend.
Reconciliation request-response

post
Applications by period

https://cashcat.ph/api/v1/reconciliation/{{lender_id}}/applications/
Allow a Lender to get reconciliation information by applications that were sent in a period
Request
Response
Request
Path Parameters
lender_id
required
string
Lender ID in the Cashcat's back-end. Please, ask support@cashcat.ph to provide this value for your company.
Headers
token
required
string
Security token to get data from Cashcat. Please, ask support@cashcat.ph to issue a token for your company.
Body Parameters
filter
required
object
Use filter to get information from needed period
Response
200: OK

Filter

UTC warning: Cashcat operates only with UTC timestamp values. The data time values in the database are stored in UTC.

Example of the filter object
{
"filter": {
"timestamp_from": 1577836800,
"timestamp_to": 1609459200
},
"token": "xxxxx"
}

post
Postbacks by period

https://cashcat.ph/api/v1/reconciliation/:lender_id/postbacks/
Allow a Lender to get reconciliation information by received postbacks that were sent by the Lender to the Cashcat in a period
Request
Response
Request
Path Parameters
lender_id
required
string
Lender ID in the Cashcat's back-end. Please, ask support@cashcat.ph to provide this value for your company.
Response
200: OK
JSON Response
{
"filter": {
"timestamp_from": 1577836800,
"timestamp_to": 1609459200
},
"total_amount": 1.5,
"total_count": 1,
"postbacks": [
{
"id": 19280,
"revenue": 1.5,
"status": "app",
"created_on": 1582285414,
"modified_on": 1582285414,
"ext_id": "",
"repeat": ""
}
]
}
JSON Payload
{
"filter": {
"timestamp_from": 1577836800,
"timestamp_to": 1609459200
},
"token": "xxxx"
}

Status Conversion

Note, that the Cashcat converts statuses from the Lenders to own status map.

Example: if you're sending status Approved it will be converted to app.

Most common statuses are: app, rej, pen, pas that corresponds to Approved, Rejected, Pending, Passed or their alternatives.

Approved (app) is the payable status. So if you send postback with status Pending but this is payable status for your case - it will be converted to app

UTC warning: Cashcat operates only with UTC timestamp values. The data time values in the database are stored in UTC.