Transactions (v1.0)
S
Written by Sascha Hoffmann
Updated over a week ago

Simple REST API to get all your statistics and transactions programmatically.

Authorization

For your authorization, you need a token. In order to receive a token please read advanced API - Get an access token.

SiteIds

The siteId is a unique identifier of your registered ad spaces. You'll find the ID in the user interface. You can request one or multiple site Ids in the same request.

Endpoint

https://api.advanced-store.com/publishers/transactions/1.0/


โ€‹Example request

curl --location 'https://api.advanced-store.com/publishers/transactions/1.0/?endDate=1701176201&startDate=1698793200&size=10&page=1&siteIds=1267%2C25' \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer ory_********'

GET parameters reference

Name

Description

page

Page number for the pagination

integer, mandatory

size

Set the page size

integer, mandatory

siteIds

Ids of all pages you like to include in the response

mandatory
Example: 1,2,3

startDate

Timestamp of the starting date

mandatory
Example: 1696151815

endDate

Timestamp of the ending date

mandatory
Example: 1699151802

programId

Id if you like to filter for a single program

optional

statusId

optional

dateRangeType

Reference for the start and end date

optional
'updatedAt' | 'createdAt'

Example response:
โ€‹

{
"totalEntries": 2,
"currentPage": 1,
"totalPageCount": 1,
"pageSize": 10,
"transactionDataList": [
{
"transactionDate": 1699114860000,
"commission": X.XX,
"basketValue": XXX.XX,
"clickTime": 1697899620000,
"program": "XXX",
"programId": "28649",
"site": "XXX",
"siteId": "25",
"status": "pending",
"subIdOrText": "SUMMERCAMPAIGN2",
"transactionId": "1454126308",
"transactionType": "sale(PC)",
"trackingCategory": "Full price item",
"updatedOn": 1699117069561,
"conversionTime": "1215240000"
},
{
"transactionDate": 1700059140000,
"commission": X.XX,
"basketValue": XXX.XX,
"clickTime": 1700057400000,
"program": "XXX",
"programId": "28649",
"site": "XXX",
"siteId": "25",
"status": "pending",
"subIdOrText": "SUMMERCAMPAIGN1",
"transactionId": "1463351349",
"transactionType": "sale(PC)",
"trackingCategory": "Full price item",
"updatedOn": 1700067702247,
"conversionTime": "1740000"
}]
}

Answer Explanation

status

  • pending - transaction is still open

  • confirmed - transaction is approved but not paid

  • paid - transaction is paid out

Did this answer your question?