# <font>Gift Bonus Code</font>

## Request URL
>{API_URL}

## Request Parameters

| Field Name | Type   | Length | Required | Description                                      |
|------------|--------|--------|----------|--------------------------------------------------|
| itype      | string | 21     | Yes      | 26 = Merchant grants bonus code to player        |
| authcode   | string | 32     | Yes      | Agent identifier, assigned by the provider       |
| authkey    | string | 32     | Yes      | Agent secret key, assigned by the provider       |
| account    | string | 128    | Yes      | Player login account                             |
| score      | int    | 64     | Yes      | Bonus code amount to be granted (must be > 0)    |

## Example

- **URL**:  
    - {API_URL}

- **HTTP Method**:  
    - `POST`

- **Form Data**:  
    > Content-Type: `application/x-www-form-urlencoded`

    ```
    itype: 26,
    authcode: test001,
    authkey: 123456,
    account: test123,
    score: 1000.00
    ```

## Response Fields

| Field Name | Type   | Length | Description                                              |
|------------|--------|--------|----------------------------------------------------------|
| ret        | int    | 32     | -1 indicates success; other than -1 indicates failure    |
| info       | string | 128    | Response message                                         |

## Response Format

```
{
    "ret": -1,
    "info": "ok"
}
```