PayoutMethod-Delete-v6

From Barion Documentation
Jump to navigation Jump to search

Barion API: DELETE v6/recipients/{recipientid}/payout-methods/{payoutmethodid}

DELETE /v6/recipients/{recipientid}/payout-methods/{payoutmethodid}

This API endpoint deletes an existing payout method from a recipient.

Prerequisites before use:

Authentication

Barion Wallet Authentication

Input properties

Property name Property type Limitations and constraints Description
Idempotency-Key GUID
  • Optional
Idempotency key used to safely retry requests without duplicating operations. Passed in the request header. See Idempotency-Key.
recipientid String
  • Required
  • Format: rcp_<ordered-base64-ulid>
ID of an existing recipient. Passed as a path parameter.
payoutmethodid String
  • Required
  • Format: pout_<ordered-base64-ulid>
ID of an existing payout method owned by the recipient. Passed as a path parameter.

Output properties

HTTP status code: 204 No Content

The response body is empty.

To find out which errors this endpoint can produce, visit the Calling the API – Handling the response page. Note that this endpoint uses camelCase field names in error responses.

Possible error messages

Condition ErrorCode HTTP status code
Authentication fails 401
Referenced recipient is not connected to the opened wallet RecipientForbidden 403
Referenced payout method is not connected to the recipient PayoutMethodForbidden 403
Recipient not found RecipientNotFound 404
Payout method does not exist PayoutMethodNotFound 404