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

# Delete a Registered Beneficiary

> Remove a previously approved payee from your Gcashier Pay account using sp1402. Deleted payees cannot receive funds and cannot be restored.

When you no longer need a registered beneficiary — for example, when a business relationship ends or an account is closed — use **sp1402** to permanently remove them from your Gcashier Pay account. You identify the payee to delete using the `payeeId` that was assigned during registration and returned to you via the sp3401 webhook. Once deleted (status `05`), the payee cannot receive future payments and the record cannot be restored; you would need to re-register the beneficiary using [sp1401](/api/payees/beneficiary-registration) if you require them again in the future.

## Endpoint

```
POST https://{baseUrl}/api/sp1402
```

## Request Parameters

<ParamField body="merOrderNo" type="string" required>
  Your unique merchant order number for this deletion request. This value is used for idempotency — submitting the same `merOrderNo` twice will not delete the payee a second time.
</ParamField>

<ParamField body="payeeId" type="string" required>
  The unique identifier of the beneficiary you wish to delete. This is the `payeeId` returned in the sp3401 webhook notification after the payee was originally approved via sp1401. Maximum 50 characters.
</ParamField>

## Request Example

```json theme={null}
{
  "merOrderNo": "318490344638900",
  "payeeId": "f56730a68be648acb3fd089fde1a3bfc"
}
```

## Response Body

When `respCode` is `S00000`, the deletion was processed successfully and the payee's status is updated to `05`.

<ResponseField name="merOrderNo" type="string" required>
  Your original merchant order number, echoed back for correlation.
</ResponseField>

<ResponseField name="bizFlowNo" type="string" required>
  Gcashier Pay's internal flow reference number for this deletion request.
</ResponseField>

<ResponseField name="status" type="string" required>
  The updated status of the payee record. A successful deletion will return:

  | Value | Description          |
  | ----- | -------------------- |
  | `05`  | Deleted successfully |
</ResponseField>

## Response Example

```json theme={null}
{
  "merOrderNo": "318490344638900",
  "bizFlowNo": "74821033119540200031",
  "status": "05"
}
```

<Warning>
  Deletion is **permanent and irreversible**. Ensure you are referencing the correct `payeeId` before submitting this request. Any in-flight payment orders associated with this payee should be settled or cancelled before deletion.
</Warning>