Skip to main content
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 if you require them again in the future.

​
Endpoint

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

​
Request Parameters

​
merOrderNo
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.
​
payeeId
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.

​
Request Example

{
  "merOrderNo": "318490344638900",
  "payeeId": "f56730a68be648acb3fd089fde1a3bfc"
}

​
Response Body

When respCode is S00000, the deletion was processed successfully and the payee’s status is updated to 05.
​
merOrderNo
string
required
Your original merchant order number, echoed back for correlation.
​
bizFlowNo
string
required
Gcashier Pay’s internal flow reference number for this deletion request.
​
status
string
required
The updated status of the payee record. A successful deletion will return:
ValueDescription
05Deleted successfully

​
Response Example

{
  "merOrderNo": "318490344638900",
  "bizFlowNo": "74821033119540200031",
  "status": "05"
}
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.