API Commit

API Ghi nhận thanh toán và xác nhận xuất vé

Specification

• URL: <API_GATEWAY>/api/partner/commit

• Method: POST

• Description: Request to commit a booking with complete information and finalize payment.

• 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 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>|<partner_trans_id>|<product_type>

  Original data schema:

  <access_code>|<booking_number>|<partner_trans_id>|<product_type>|<signature>

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

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

  • partner_trans_id (String, optional): Partner's transaction identifier. If not provided, the default value will be set to bookingNumber.

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

    ứng với loại sản phẩm được mua

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": "..."
}

Example of Gotadi result page: