VoidRequest

Function Description

Through VoidRequest API, users could apply for voiding tickets after tickets are issued. Passengers that are included in the order are allowed to void ticket if void service time is available. Please refer to void service time that is provided in TicketingNumPush_V2 API.

noteVoidRequest_V2 API has different structure with VoidRequest，VoidRequest_V2 API adds passenger name and passenger sex，while removes passenger card number and card type。

Error Code List

errorCode	errorMsg	Description
0	ok	request has been processed successfully
S001	System error	system error
P001	-	wrong parameter
P002	XXXXX is missing.	parameter is missing
P006	Invalid parameter.	wrong parameter
B002	Partner is not exists	PartnerID does not exist.
B003	Illegal sign	Illegal sign. Please check your signature.
B009	order status invalid	order status is invalid
B010	order not exist	order number does not exist
B048	Invaild buyer	buyer does not match
V001	Illegal void time	the time limit for voiding tickets has been exceeded
V002	passenger(s) not allowed to void. Origin order has no ADT remain	passenger(s) not allowed to void. Origin order has no ADT remain
O001	passenger does not match the order	passenger does not match the order
O002	some passengers submitted other after sale requests, so failure to submit void request.	some passengers submitted other after sale requests, so failure to submit void request.
O003	the new or original journey exists unaccompanied minor.	the new or original journey contains unaccompanied minor.

Sex

Name	Description
M	Male
F	Female

Request

Body Params application/json

Example

{
    "authentication": {
		"sign": "{{sign}}",
		"partnerId": "{{partnerId}}"
    },
    "voidRequest":{
        "passengers":[
            {
            "lastName":"WONG",
            "firstName":"LEONB",
            "birthday":"1990-01-01",
            "sex":"M"
            }
        ],
        "orderNum":"915656792701128401" 
    }
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200Success

application/json

Bodyapplication/json

Example

{
    "errorCode": "0",
    "errorMsg": "ok",
    "data": {
        "orderNum": "915634179313900301",
        "voidOrderNum": "915634179313900302",
        "passengers": [
            {
                "lastName": "WONG",
                "firstName": "LEONB",
                "birthday": "1990-01-01",
                "sex": "M"
            }
        ]
    }
}

🟢200Error

Function Description#

Error Code List#

Sex#

Request

Request Code Samples

Responses

Function Description

Error Code List

Sex