# Create Webhook URL

### **Request** URI <a href="#payin-by-creditcard" id="payin-by-creditcard"></a>

`POST` `/issuing/webhook/create`

### **Request Body**

**Refer to :** [**common**](https://docs.pagsmile.com/issuing-card-api/common)

**Biz\_data :**

<table><thead><tr><th width="175.69140625">Name</th><th width="186.28515625">Type</th><th>Description</th></tr></thead><tbody><tr><td>webhook_type<mark style="color:red;">*</mark></td><td>integer</td><td>Webhook type.Refer to <a href="../../../data/dictionary-item/webhooktype">webhookType</a></td></tr><tr><td>webhook_url<mark style="color:red;">*</mark></td><td>string(128)</td><td>Webhook URL</td></tr><tr><td>webhook_desc</td><td>string(128)</td><td>Order number. Globally unique</td></tr></tbody></table>

### **Request** Example <a href="#example" id="example"></a>

```
{
    "app_id": "00000000000000000",
    "partner_id": "00000000000000000",
    "request_id": "b2DCFbAb-212E-Cc5d-2B99-c5f260c1",
    "timestamp": "2025-04-07 13:57:06",
    "format": "JSON",
    "version": "2.0",
    "sign_type": "RSA",
    "biz_data": {
        "webhook_type": 1,
        "webhook_url": "https://random1744005426.com",
        "webhook_desc": "this is desc"
    },
    "random_key": "<generated_key>"
}
// The biz_data in this example needs to be encrypted!
```

### Response <a href="#example" id="example"></a>

| Name        | Type | Description |
| ----------- | ---- | ----------- |
| webhook\_id | long | Webhook ID  |

{% tabs %}
{% tab title="200:OK" %}

```
{
    "code": "10000",
    "msg": "Success",
    "total": 1,
    "random_key": "<random key used for decryption>",
    "sign_type": "RSA",
    "app_id": "00000000000000000",
    "data": {
        "webhook_id": 3
    }
}
// The data in this example has already been decrypted.
```

{% endtab %}

{% tab title="400: invalid-signature" %}

```
{
    "code": "40002",
    "msg": "Business Failed",
    "sub_code": "invalid-signature",
    "sub_msg": "invalid signature"
}
```

{% endtab %}
{% endtabs %}