Journey Token Creation

Note:

• For APIs used for Shop, the API key is: <api_key>. The base_url information of the Shop.

• For APIs used for Partner, the API key is: <shop_key>. The base_url information of the Partner.

CreateJourney

post

Body

application/json

oa_idstring · int64Optional

phonestringOptional

token_typestring · enumOptionalPossible values:

Responses

200

A successful response

application/json

post

$BASE_URL.Zalo/CreateJourney

HTTPcURLJavaScriptPython

POST $BASE_URL.Zalo/CreateJourney HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 54

{
  "oa_id": "text",
  "phone": "text",
  "token_type": "unknown"
}

200

A successful response

{
  "created_at": "2025-12-20T11:26:03.983Z",
  "error_code": 1,
  "error_message": "text",
  "expired_at": "2025-12-20T11:26:03.983Z",
  "id": "text",
  "is_charged": true,
  "journey_id": "text",
  "journey_token": "text",
  "phone": "text",
  "status": "Z",
  "updated_at": "2025-12-20T11:26:03.983Z"
}

Request:

curl --location '$BASE_URL.Zalo/CreateJourney' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer $API_KEY' \
--data '{
    "oa_id": "<int64>",
    "phone": "<string>",
    "token_type": "unknown"
}'

Response:

{
  "created_at": "2019-08-24T14:15:22Z",
  "error_code": 0,
  "error_message": "string",
  "expired_at": "2019-08-24T14:15:22Z",
  "id": "string",
  "is_charged": true,
  "journey_id": "string",
  "journey_token": "string",
  "phone": "string",
  "status": "Z",
  "updated_at": "2019-08-24T14:15:22Z"
}

Request body structure

Parameters	Data type	Describe
oa_id require	int64	OA ID
phone require	string	Recipient's phone number. Note: Phone number must be linked to Zalo account
token_type	string (uqTokenType) Enum	" unknown" " token_logistics_7" token_logistics_30" " token_coach_bus_7" " token_coach_bus_30" If no token_type is passed the default istoken_logistics_7

Return data attribute structure

Parameters	Data type	Describe
id	int64	Journey ID on eTelecom system
journey_id	string	Journey ID
journey_token	string	Trip code activated
expires_at	string<date-time>	Expiration time
phone	string	Recipient phone number
status	string	Status Z: Newly created P: Enable N: Disable
error_code	int	Error code
error_message	string	Error information
is_charged	bool	To charge or not to charge
updated_at	string<date-time>	Update time
created_at	string<date-time>	Creation time