API Check commit result

API Truy vấn kết quả xuất vé/phòng

Specification

• URL: <API_GATEWAY>/api/partner/query-trans

• Method: POST

• Description: API allows partners to query the ticket/room issuance result.

• Security Requirements: Data must be encrypted and include an electronic signature.

Request

Model

• key (string, required): Decryption key for the data (already encrypted). Refer to the section "Data Encryption and Electronic Signature Verification" for details on how it is generated.

• data (string, required): Encrypted data including an electronic signature. Refer to the section "Data Encryption and Electronic Signature Verification" for details on how it is generated.

• Signature data schema:

  <access_code>|<booking_number>

  Original data schema:

  <access_code>|<booking_number>|<signature>

  • access_code (String, required)

    Access code provided by Gotadi to the Partner.

  • bookingNumber (String, required)

    Reference code used for the booking.đến booking

Example

{
"data": "...",
"key": "..."
}

Response

Model

• key (String, required): Decryption key for the data (already encrypted). Refer to the section "Data Encryption and Electronic Signature Verification" for decryption instructions.

• data (String, required): Encrypted data including an electronic signature. Refer to the section "Data Encryption and Electronic Signature Verification" for decryption instructions.

  Signature data schema:

  <access_code>|<booking_number>|<error_code>|<product_type>|<properties>|<return_url>|<total_amount>

  Original data schema:

  <access_code>|<booking_number>|<error_code>|<product_type>|<properties>|<return_url>|<signature>|<total_amount>

  • access_code (String, required): Access code provided by Gotadi to the Partner.

  • booking_number (String, required): Unique reference code for the booking.

  • error_code (String, required): Error code.

  • product_type (String, optional): Product type, with values AIR or HOTEL, corresponding to the purchased product type.

  • properties (String, optional): Additional information returned to the partner in JSON string format.

  • return_url (String, optional): Gotadi’s transaction result page, used if the partner does not build their own final result page.

  • total_amount (Double, required): Total amount to be paid.

Example

{
"data": "...",
"key": "..."
}