Delete

This method can be used to delete a particular W-8BEN request or a submission.

If there are multiple W-8BENs requested in a Submission. All the W-8BEN records under the submission will be deleted.

DELETE FormW8Ben/Delete

Request Body

Field	Type	Description
SubmissionId	Guid	Unique Identifier for a Submission.
PayeeRef	String	Unique identifier of a recipient. Either PayeeRef or Email is required Size Range: 1-50
Email	String	Email Address of the recipient. Size Range: 1-50

Response Body

Field	Type	Description
FormW8BENRecords	Object	Details of the W-8BENs requested for delete
SubmissionId	Guid	Unique identifier of a submission.
PayeeRef	String	Unique identifier of the recipient
Email	String	Email Address of the recipient.
W8BENStatus	String	Status of the W-8BEN
StatusTs	String	Timestamp of the status
Errors	Object	Shows detailed error information.

Scenario 1 : Delete a recipient with SubmissionId

FormW8Ben/Delete?SubmissionId=019c8aec-41fe-4b80-883a-441665dc004a

Response 1

{ "FormW8BENRecords": [   {     "SubmissionId": "019c8aec-41fe-4b80-883a-441665dc004a",     "PayeeRef": "Pe123451234",     "Email": "steve@abcinc.com",     "W8BENStatus": "DELETED",     "StatusTs": "2021-02-22 04:24:09 -05:00"   } ], "Errors": null}

Scenario 2: Delete a recipient with PayeeRef

FormW8Ben/Delete?PayeeRef=Pe123451234

Response 2

{   "FormW8BENRecords": [       {           "SubmissionId": "58c06235-d278-4d4e-9f0e-cca9d21f38df",           "PayeeRef": "Pe123451234",           "Email": "steve@abcinc.com",           "W8BENStatus": "DELETED",           "StatusTs": "2021-04-09 13:48:30 -04:00"       },       {           "SubmissionId": "af0835ad-b26c-4a94-8d56-6e8f4cd36cb1",           "PayeeRef": "Pe123451234",           "Email": "steve@abcinc.com",           "W8BENStatus": "DELETED",           "StatusTs": "2021-04-09 13:48:30 -04:00"       }   ],   "Errors": null}

Scenario 3: Delete a recipient with Email

FormW8Ben/Delete?Email=steve@abcinc.com

Response 3

{ "FormW8BENRecords": [   {     "SubmissionId": "019c8aec-41fe-4b80-883a-441665dc004a",     "PayeeRef": "Pe123451234",     "Email": "steve@abcinc.com",     "W8BENStatus": "DELETED",     "StatusTs": "2021-02-22 04:24:09 -05:00"   } ], "Errors": null}