# Beneficiary Delete

> Delete a beneficiary that is no longer needed.

```yaml
openapi: 3.1.0
info:
  title: Beneficiary Delete
  version: 1.0.0
  description: Delete a beneficiary that is no longer needed.
paths:
  /api/v1/beneficiary/remove:
    post:
      summary: Beneficiary Delete
      description: Delete a beneficiary that is no longer needed.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                merchantNo:
                  type: string
                  description: Merchant number assigned by Onerway. Retrieve it from the merchant
                    portal or onboarding material after your sandbox or
                    production account is created.
                beneficiaryId:
                  type: string
                  description: Beneficiary ID to delete.
                sign:
                  type: string
                  description: Request signature string. Generate it according to the Transfer
                    request-signing rules with your merchant private key.
              required:
                - merchantNo
                - beneficiaryId
                - sign
            examples:
              delete-beneficiary:
                summary: Delete beneficiary request
                value:
                  beneficiaryId: 1899696430844878800
                  merchantNo: "800181"
                  sign: 12312sdfadsf
      responses:
        "200":
          description: Delete beneficiary response
          content:
            application/json:
              schema:
                type: object
                properties:
                  respCode:
                    type: string
                    description: Response code returned by Onerway.
                  respMsg:
                    type:
                      - string
                      - "null"
                    description: Response message returned by Onerway.
                    x-onerway-value:
                      nullable: true
                      when:
                        en: No response message is returned.
                        zh: 未返回响应信息时为 `null`。
                  data:
                    type: object
                    properties:
                      beneficiaryId:
                        type: string
                        description: Deleted beneficiary ID.
                      status:
                        type: string
                        description: Deletion status returned for the beneficiary record.
                    description: Deleted beneficiary result.
              examples:
                beneficiary-deleted:
                  summary: Delete beneficiary response
                  value:
                    respCode: "20000"
                    respMsg: Success
                    data:
                      beneficiaryId: 1899696430844878800
                      status: DELETED
```