> ## Documentation Index
> Fetch the complete documentation index at: https://developers-sandbox.uqpaytech.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 受益人创建

> 当受益人创建成功或失败时发送。

## 事件类型

| 事件类型 | 描述 |
| - | - |
| `beneficiary.successful` | 受益人创建成功。 |
| `beneficiary.failed` | 受益人创建失败。 |

Mastercard Send 受益人的 `data.payment_type` 为 `CARD`。`data.beneficiary_bank_details` 是包含 `card_expiry` 等卡资料的 JSON 编码字符串，读取字段前须先解码。


## OpenAPI

````yaml webhooks-banking.yaml webhook beneficiaryCreated
openapi: 3.1.0
info:
  title: Banking Webhooks
  version: 1.6.0
  description: |
    Webhook events for the Global Account product. UQPAY sends these events to
    your registered webhook endpoint as HTTP POST requests with a JSON body.

    All events share a common envelope (`event_id`, `event_name`, `event_type`,
    `source_id`, `version`) and carry event-specific data in the `data` field.
servers: []
security: []
paths: {}

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.