Payment API

Voucher validation API

GET: /api/payments/voucher/validate

Validate voucher for specific booking

Request Body

Parameter
Description

bookingNumber (String, Required)

Booking Identifier

voucherCode (String, Required)

Voucher code

Example

{
    "bookingNumber": "ADCO2203011523483",
    "voucherCode": "AXOLXHLp"
}

Response

Parameter
Description

bookingNumber (String)

Booking identifier

discountAmount (Double)

Discount money amount

trackingCode (String)

Identifier for booking with voucher

voucherCode (String)

Voucher code

voucherValid (Boolean)

Is valid voucher code?

duration (Integer, Optional)

errors (Array[Error], Optional)

infos (Array[Info], Optional)

success (Boolean, Optional)

textMessage (String, Optional)

Example

{
    "isSuccess": true,
    "duration": 3896,
    "textMessage": null,
    "errors": null,
    "infos": null,
    "bookingNumber": "ADCO2203011523483",
    "voucherCode": "AXOLXHLp",
    "voucherValid": true,
    "trackingCode": "track_xbhwiFai1HNQNCQLe2PmvdxJu/rd5zEG7NGuvjHI5CY=",
    "discountAmount": 1000,
    "percentOff": null,
    "type": "AMOUNT",
    "success": true
}

Voucher usage confirmation API

GET: /api/payments/voucher/redeem

Redeem voucher for specific booking

Request Body

Parameter
Description

bookingNumber (String, Required)

Booking identifier

voucherCode (String, Required)

Voucher code

trackingCode (String, Required)

Tracking code used in api validate

Example

{
    "bookingNumber": "ADCO2203011523483",
    "trackingCode": "track_xbhwiFai1HNQNCQLe2PmvdxJu/rd5zEG7NGuvjHI5CY="
    "voucherCode": "AXOLXHLp"
}

Response

Parameter
Description

bookingNumber (String)

Booking identifier

redeemValid (Boolean)

Confirmation of success using Voucher

voucherCode (String)

Voucher code

duration (Integer, Optional)

errors (Array[Error], Optional)

infos (Array[Info], Optional)

success (Boolean, Optional)

textMessage (String, Optional)

Example

    {
        "isSuccess": true,
        "duration": 6508,
        "textMessage": null,
        "errors": null,
        "infos": null,
        "voucherCode": "gtd_fpt_test",
        "bookingNumber": "ADCO2203101541927",
        "redeemValid": true,
        "success": true
    }

Booking Payment Request API

GET: /api/partner/place-order

Request payment booking - initiate payment order

Note

  • Security requirements: Encrypt data and include a digital signature

  • Request: Does not require encryption and includes a digital signature

  • Response: Part of the response data is required to be encrypted and accompanied by a digital signature

Request

Parameter
Description

bookingNumber query (string, required),

Reference code to booking

- bookingNumber `query` (string, required),

    !!! quote ""

        Reference code to booking

Response

Model
  • result (String, optional),

    Information returned in the format:

    ```
    <payment_url>?key=<encrypted_key>?data=<encrypted_data>
    ```
    
    *Signature data schema:*
    
    ``` 
    <access_code>|<booking_number>|<product_type>|<total_amount>
    ```
    
    *Original data schema:*
    ```
    <access_code>|<booking_number>|<product_type>|<signature>|<total_amount>
    ```
    
    - access_code (String, required)
    
        !!! quote ""
    
            Access code provided by Gotadi to Partners.
    
    - bookingNumber (String, optional)
    
        !!! quote ""
    
            Code used to refer to booking
    
    - product_type (String, optional)
    
        !!! quote ""
    
            Type of product, whose value is AIR or HOTEL corresponding to the type of product purchased
    
    - total_amount (String, optional)
    
        !!! quote ""
    
            Total payment amount
    
    - payment_url (String, required)
    
        !!! quote ""
    
            URL navigate to payment page
    
    - encrypted_key (String, required)
    
        !!! quote ""
    
            Key decrypts (encrypted) data. How to decrypt refer to the section: Encryption of transmission data and digital signature authentication
    
    - encrypted_data (String, required)
    
        !!! quote ""
    
            Data with digital signature (encrypted). How to decrypt refer to the section: Encryption of transmission data and digital signature authentication
  • duration (integer, optional),

  • errors (Array[Error], optional),

  • infos (Array[Info], optional),

  • success (boolean, optional),

  • textMessage (string, optional)


Payment Recording and Booking Commit API

POST: /api/partner/commit

Yêu cầu commit booking được cập nhật đầy đủ thông tin và hoàn tất thanh toán

Chú ý

  • Security requirements: Encrypt data and include a digital signature

  • Request: Does not require encryption and includes a digital signature

  • Response: Part of the response data is required to be encrypted and accompanied by a digital signature

Request Body

Model

Model
  • key (string, required),

    Data decrypted key. How to decrypt refer to the section: Encryption of transmission data and digital signature authentication

  • data (string, required),

    Data with digital signature (encrypted). How to decrypt refer to the section: Encryption of transmission data and digital signature authentication

    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 Partners.

    • bookingNumber (String, required)

      Code used to refer to booking

    • partner_trans_id (String, optional)

      Partner transaction identifier. If the partner does not pass a value to this field, the default value will be assigned using booking_number

    • product_type (String, required)

      Type of product, whose value is AIR or HOTEL corresponding to the type of product purchased

Example

Response

Model

Model
  • key (String, required)

    Data decrypted key. How to decrypt refer to the section: Encryption of transmission data and digital signature authentication

  • data (String, required)

    Data with digital signature (encrypted). How to decrypt refer to the section: Encryption of transmission data and digital signature authentication

    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 Partners.

    • booking_number (String, required)

      Code used to refer to booking

    • error_code (String, required)

      Error code

    • product_type (String, optional)

      Type of product, whose value is AIR or HOTEL corresponding to the type of product purchased

    • properties (String, optional)

    • return_url (String, optional)

    • total_amount (Double, required)

PreviousAPIs for BookNextAboutMade with Material for MkDoc

Last updated