Create Webhook URL

Establish a callback endpoint to receive Pagsmile notifications for specific event types.

Request URI

POST /issuing/webhook/create

Request Body

Refer to : common

Biz_data :

Name	Type	Description
webhook_type*	integer	Webhook type.Refer to webhookType
webhook_url*	string(128)	Webhook URL
webhook_desc	string(128)	Order number. Globally unique

Request Example

{
    "app_id": "00000000000000000",
    "partner_id": "00000000000000000",
    "sub_partner_id": "",
    "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

Name	Type	Description
webhook_id	long	Webhook ID

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.

400: invalid-signature

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