AccessTrade.vn
  • TÀI LIỆU API HƯỚNG DẪN PUBLISHER
  • API DÀNH CHO PUBLISHER BẢN TIẾNG VIỆT
    • Authentication
    • Lấy danh sách campaigns
    • Tạo tracking link
    • Lấy danh sách giao dịch
    • Lấy danh sách đơn hàng v2
    • Lấy thông tin sản phẩm của đơn hàng
    • Lấy thông tin chi tiết sản phẩm
    • Lấy thông tin datafeeds
    • Lấy thông tin vouchers / coupons / deals
      • Hướng dẫn lấy mã nhúng danh sách khuyến mãi lên website
      • [Wordpress] Hướng dẫn nhúng vào bài post
      • [Wordpress] Hướng dẫn tạo 1 trang riêng nhúng code
      • API - Lấy danh sách thông tin khuyến mại theo nhà cung cấp & ngành hàng.
    • Lấy thông tin các khuyến mại đang hoạt động
    • Top các sản phẩm bán chạy nhất
    • Errors
  • API PUBLISHER ENGLISH VERSION
    • Authentication
    • Get the campaigns list
    • Create tracking link
    • Get the list of commission ratio of campaign
    • Get the list of transaction
    • Get the list of order v2
    • Get products information of the order
    • Get detailed information of the product
    • Get Datafeeds information
    • Get promotional information
    • Top selling products
    • Errors
    • Get detailed information of the order
Powered by GitBook
On this page

Was this helpful?

  1. API PUBLISHER ENGLISH VERSION

Get the list of transaction

HTTP Request

https://api.accesstrade.vn/v1/transactions

Note:

  • Limit: 10 requests / 1 minute

Query Parameters

The parameters are passed into HTTP Request according to Key-Value pairs, begin the parameters with the sign “?” and separate the parameters with the sign “&”. Ex:

https://api.accesstrade.vn/v1/transactions?since=2021-01-01T00:00:00Z&until=2021-01-03T00

Parametter

Required

Description

since

Required

Time the report begins, according to ISO format, example “2019-08-01T00:00:00Z”

until

Required

Time the report ends, according to ISO format, example “2019-08-01T00:00:00Z”

page

Optional

Page order. Starting from 1. Default 1

offset

Optional

Offset value, default 0.

limit

Optional

Number of orders returned per page. Default 100.

merchant

Optional

Merchant name. ex: tikivn.

utm_source

Optional

Ex: facebook

utm_campaign

Optional

utm_medium

Optional

Ex: email

utm_content

Optional

status

Optional

Status

  • 0: hold

  • 1: approved

  • 2: rejected

is_confirmed

Optional

Transaction status:

  • 0: unapproved

  • 1: approved (If there is is_confirmed parameter but no status, the default field status=1)

transaction_id

Optional

Transaction codes, can filter 1 (transaction_id=1234567) or multiple (transaction_id=1234567,7654321) using commas "," to separate codes.

update_time_start

Optional

Report start time according to transaction update time (ISO format), for example “2016-08-01T00:00:00Z”.

update_time_end

Optional

Report end time according to transaction update time (ISO format), for example “2016-08-01T00:00:00Z”.

API response returns:

"total": 4147,
    "data": [
        {
            "merchant": "tikivn",
            "status": 1,
            "update_time": "2022-07-19T17:32:35",
            "click_url": "https://ti.ki/add/TNWGVSKG?utm_term=TAPM.Yr8FIzkUqtxX6WDq6wmjdLH9nzfwPYBgD8nSkKOaR8B3lolr_TAPP.684099_TAPT.TI3&TIKI_URI=https%3A%2F%2Ftiki.vn&atnct1=44f683a84163b3523afe57c2e008bc8c&atnct2=Yr8FIzkUqtxX6WDq6wmjdLH9nzfwPYBgD8nSkKOaR8B3lolr&atnct3=PkIKY0000nw00enur",
            "conversion_platform": "mobile_app",
            "utm_campaign": "4348614231480407268",
            "product_category": "1520_app",
            "utm_content": "",
            "transaction_time": "2022-05-03T02:31:19",
            "product_image": "",
            "utm_source": "123488589",
            "transaction_value": 442000.0,
            "_extra": {
                "parameters": {
                    "utm_campaign": "4348614231480407268",
                    "click_url": "https://ti.ki/add/TNWGVSKG?utm_term=TAPM.Yr8FIzkUqtxX6WDq6wmjdLH9nzfwPYBgD8nSkKOaR8B3lolr_TAPP.684099_TAPT.TI3&TIKI_URI=https%3A%2F%2Ftiki.vn&atnct1=44f683a84163b3523afe57c2e008bc8c&atnct2=Yr8FIzkUqtxX6WDq6wmjdLH9nzfwPYBgD8nSkKOaR8B3lolr&atnct3=PkIKY0000nw00enur",
                    "click_user_agent": "Mozilla/5.0 (iPhone; CPU iPhone OS 14_3 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/14.0.2 Mobile/15E148 Safari/604.1",
                    "at_unique_id": "7sFsxcWKOWYPunC3BCfg6Znxat",
                    "utm_tool": "deeplink",
                    "utm_source": "123488589"
                },
                "device_model": "iPhone",
                "device_family": "iPhone",
                "device_brand": "Apple",
                "device_type": "mobile",
                "device": "Apple iPhone",
                "os": "iOS",
                "browser": "Mobile Safari"
            },
            "reason_rejected": "",
            "category_name": "Sức khỏe và làm đẹp_app",
            "utm_term": "",
            "product_id": "9446586652188@tikivn@9446586652188",
            "is_confirmed": 0,
            "confirmed_time": "2022-06-30T23:59:59",
            "product_price": 442000.0,
            "id": "9591ccbef06080a1dd8f98d9b371537e",
            "commission": 53040.0,
            "customer_type": "",
            "conversion_id": 115157422,
            "utm_medium": "",
            "product_quantity": 1,
            "click_time": "2022-05-03T02:18:56",
            "product_name": "",
            "transaction_id": "602528593"
        }

Description of results:

Parametter

Description

total

Number of conversions, calculated by product.

data.status

Status of conversion

  • 0: Pending or hold

  • 1: Approved

  • 2:Rejected.

data.merchant

Merchant name

data.click_time

Click time

data.transaction_id

Transaction ID (Order).

data.transaction_time

Transaction time, according to ISODate.

data.update_time

Time to update transaction information, according to ISODate.

data.confirmed_time

Transaction approval time, according to ISODate.

data.is_confirmed

Transaction status: 0 - unapproved, 1 - approved

data.transaction_value

Transaction value.

data.commission

Commissions for publishers.

data.product_id

Product ID.

data.product_price

Price of the product.

data.product_quantity

The quantity of products.

data._extra

Information related to the operating system and browser.

data._utm*

Utm parameter values.

data.category_name

Category name

data.conversion_id

ID of conversion

data.conversion_platform

The foundations of conversion

data.customer_type

Customer type

data.product_category

Category of product

data.product_image

Image of product

data.product_name

Product name

data.reason_reject

Reason reject

PreviousGet the list of commission ratio of campaignNextGet the list of order v2

Last updated 5 months ago

Was this helpful?