> For the complete documentation index, see [llms.txt](https://developer.gotadi.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.gotadi.com/english/b2b2c-partner/webview-method.md).

# Webview method

### Connection Process

<figure><img src="/files/rXEacgzL5tdFQKenySFx" alt=""><figcaption></figcaption></figure>

<details>

<summary>Step 1: Account Initialization</summary>

The partner provides the necessary information for Gotadi to create an agency account in the sandbox environment. The required information includes:

**Company Information:**

* Company Name
* Company Address
* Website Address

**Administrator Information:**

* Full Name
* Email Address
* Phone Number

**Integration Information:**

* Links to the partner’s system (e.g., product link, payment gateway link, etc.)
* Relevant integration documents
* Partner’s public key (RSA public key with a minimum length of 1024 bits)

</details>

<details>

<summary>Step 2: Providing Sandbox Environment Account</summary>

Gotadi creates an account based on the information provided by the partner and sends the account details back. The provided information includes:

* **Activation link and login credentials** for Gotadi’s B2B portal (sent to the administrator’s email).
* **Gotadi system endpoint:** `<gotadi_api_gateway>`
* **Gotadi's public key** (RSA public key with a minimum length of 1024 bits).
* **Request header parameters:**
  * **API access key:** `<api_key>`
  * **Partner access code:** `<access_code>`

</details>

<details>

<summary>Step 3: Integration and Testing</summary>

The partner activates the account and uses the information from **Step 2** to establish the connection and conduct testing in the sandbox environment.

</details>

<details>

<summary>Step 4: Acceptance Testing</summary>

Acceptance Testing in Sandbox and Go-Live

**Note:** During the testing phase, if any bookings require a refund, cancellation, or modification, please follow the instructions below.

</details>

<details>

<summary>Step 5: Training &#x26; Customer Support Coordination</summary>

Establish a communication channel between Gotadi’s customer support team and the partner.

Prioritize direct communication via OTA applications such as **Skype, Zalo, Viber**, or other suitable platforms.

Conduct **customer support training** (if needed) to ensure optimal service quality from both sides.

</details>

### **Webview Interface**

Please refer to the interface at the link below:

{% embed url="<https://uat-vendor.gotadi.com/embed_b2b2c_demo.html>" %}

{% hint style="info" %}
Gotadi can customize the color scheme upon request to match the partner's interface.
{% endhint %}

### **Terminology and Abbreviations**

| Viết tắt | Từ đầy đủ                          | Mô tả                                                                                                                                                      |
| -------- | ---------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
| URL      | Uniform Resource                   | Used to reference resources on the Internet.                                                                                                               |
| SSL      | Secure Sockets Layer               | A cryptographic protocol designed to provide secure communication over the Internet.                                                                       |
| HTTPS    | Hypertext Transfer Protocol Secure | A protocol that combines HTTP with SSL or TLS to enable secure information exchange over the Internet.                                                     |
| 3DES     | Triple DES (3DES hay TDES)         | A symmetric key algorithm that applies the DES encryption algorithm three times to each data block.                                                        |
| RSA      | Rivest–Shamir–Adleman              | A public-key cryptographic algorithm. It is the first algorithm suitable for both digital signature generation and encryption.                             |
| SHA-256  | Secure Hash Algorithm              | An algorithm used to transform a specific data segment into a fixed-length output with a high probability of uniqueness. SHA-256 returns a 256-bit result. |
|          | Chữ ký điện tử                     | Information attached to data (text, images, videos, etc.) to identify the owner of that data.                                                              |
| M        | Mandatory                          | Mandatory when calling the API                                                                                                                             |
| O        | Optional                           | Not required when calling the API; this parameter is optional depending on the use case.                                                                   |
| C        | Condition                          | This field is determined as Mandatory or Optional based on the Condition of another field when calling the API                                             |

### HTTP Response code <a href="#http-response-code" id="http-response-code"></a>

| Code | Description           |
| ---- | --------------------- |
| 200  | Success               |
| 400  | Bad Request           |
| 401  | Unauthorized          |
| 402  | Forbidden             |
| 402  | Not Found             |
| 500  | Internal Server Error |
| 503  | Service Unavailable   |

### Error code <a href="#ma-loi" id="ma-loi"></a>

| Mã lỗi | Mô tả                                                          |
| ------ | -------------------------------------------------------------- |
| 00     | Request processed successfully.                                |
| 01     | Request is being processed.                                    |
| 02     | Request processing failed.                                     |
| 03     | Request rejected due to agency account authentication failure. |
| 04     | Request rejected due to an invalid digital signature.          |
| 05     | Request rejected due to data decryption failure.               |
| 06     | Request rejected due to an invalid access code.                |
| 07     | Request rejected due to incorrect data format.                 |
| 08     | Request rejected as it has already been processed.             |
| 09     | Request not yet provessed.                                     |
| 10     | Account information not found.                                 |
| 99     | Other errors.                                                  |

### Customer Email Types

* Successful Reservation – Pending Payment
* Ticket Issued Successfully
* Reservation Failed
* Payment Failed
* Payment Successful – Ticket Not Yet Issued

### **Related Documents**

* Integration Information between Gotadi and the Partner.
* Testing Scenarios.
* Sample Source Code.