1. API Reference
Advertiser’s Developer
  • Advertiser’s Developer
  • API Reference
    • Authentication
    • Get Conversion
      GET
    • Create Conversion
      POST
    • Update Status Conversion
      PUT
  1. API Reference

Create Conversion

Developing
Môi trường sản xuất
https://prod.your-api1-server.com
Môi trường sản xuất
https://prod.your-api1-server.com
POST
https://prod.your-api1-server.com
/api/v1/postbacks/conversions
Receive postback conversions from advertisers.

Request Body (JSON)#

FieldTypeDescription
conversion_idStringUnique ID for the conversion
transaction_idStringUnique ID for the transaction
transaction_timeISO 8601Time of transaction (YYYY-MM-DDTHH:mm:ss)
click_idStringThe original click identifier
amountNumberTotal transaction amount
transaction_discountNumberApplied discount amount
itemsArrayList of items included in the transaction

Request

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200Success
application/json
Bodyapplication/json

🟠400Data error
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://prod.your-api1-server.com/api/v1/postbacks/conversions' \
--header 'Authorization: Token ' \
--header 'Content-Type: application/json' \
--data '{
  "transaction_id": "ORDER011",
  "transaction_time": "2026-03-24T22:00:00",
  "click_id": "1c7ced22f8e146ca",
  "amount": 200000,
  "items": [
    {
      "id": "vay5tr",
      "sku": "vay5tr",
      "name": "vay 5 trieu",
      "price": 100000,
      "quantity": 1,
      "category": "vay5tr",
      "category_id": "vay500"
    },
    {
      "id": "vay5tr2",
      "sku": "vay5tr",
      "name": "vay 5 trieu2",
      "price": 100000,
      "quantity": 1,
      "category": "vay5tr",
      "category_id": "vay500"
    }
  ],
  "extra": {
    "customer_type": "NEW"
  }
}'
Response Response Example
200 - Success
{
    "data": {
        "code": "00",
        "message": "success",
        "transaction_id": "ORDER011"
    },
    "message": "Postback received",
    "status": "success"
}
Modified at 2026-04-06 07:51:48
Previous
Get Conversion
Next
Update Status Conversion
Built with