Delete a member

DELETE/v0.1/merchants/{merchant_code}/members/{member_id}

Deletes a merchant member.

OAuth scopes: Requires one of: user.subaccounts, members.write.

Required permissions:

members_delete

Authorization

Use one of the following alternatives:

apiKey
oauth2 with scopes user.subaccountsmembers.write

Authorization guide

Path parameters

merchant_codestringrequired
Short unique identifier for the merchant.

Example: "MK10CL2A"
member_idstringrequired
The ID of the member to retrieve.

Example: "mem_WZsm7QTPhVrompscmPhoGTXXcrd58fr9MOhP"

Responses

200

Returns an empty response if the deletion succeeded.

Returns an empty response.

403application/problem+json

Member deletion was forbidden.

typestringrequired
format: uri
A URI reference that identifies the problem type.

Example: "https://developer.sumup.com/problem/not-found"
titlestring
A short, human-readable summary of the problem type.

Example: "Requested resource couldn't be found."
statusinteger
The HTTP status code generated by the origin server for this occurrence of the problem.

Example: 404
detailstring
A human-readable explanation specific to this occurrence of the problem.

Example: "The requested resource doesn't exist or does not belong to you."
instancestring
format: uri
A URI reference that identifies the specific occurrence of the problem.

Example: "https://api.sumup.com/v0.1/checkouts/4e425463-3e1b-431d-83fa-1e51c2925e99"

404application/problem+json

Merchant or member not found.

typestringrequired
format: uri
A URI reference that identifies the problem type.

Example: "https://developer.sumup.com/problem/not-found"
titlestring
A short, human-readable summary of the problem type.

Example: "Requested resource couldn't be found."
statusinteger
The HTTP status code generated by the origin server for this occurrence of the problem.

Example: 404
detailstring
A human-readable explanation specific to this occurrence of the problem.

Example: "The requested resource doesn't exist or does not belong to you."
instancestring
format: uri
A URI reference that identifies the specific occurrence of the problem.

Example: "https://api.sumup.com/v0.1/checkouts/4e425463-3e1b-431d-83fa-1e51c2925e99"

DELETE

Code sample

curl --request DELETE \
  --url https://api.sumup.com/v0.1/merchants/MK10CL2A/members/mem_WZsm7QTPhVrompscmPhoGTXXcrd58fr9MOhP \
  --header 'Authorization: Bearer <token>'

import SumUp from "@sumup/sdk";

async function main() {
  const client = new SumUp({ apiKey: "sup_sk_your_api_key" });

  const result = await client.members.delete(
    "MK10CL2A",
    "mem_WZsm7QTPhVrompscmPhoGTXXcrd58fr9MOhP"
  );
  console.log(result);
}

main().catch(console.error);

using System;
using System.Collections.Generic;
using System.Threading.Tasks;
using SumUp;

public static class Program
{
    public static async Task Main()
    {
        using var client = new SumUpClient();
        var response = await client.Members.DeleteAsync(
            "your-merchant-code",
            "example-id");

        Console.WriteLine(response.StatusCode);
    }
}

import com.sumup.sdk.SumUpClient;

public final class DeleteMerchantMemberSample {
  public static void main(String[] args) throws Exception {
    var client = new SumUpClient();

    client.members().delete(
            "mem_WZsm7QTPhVrompscmPhoGTXXcrd58fr9MOhP",
            "MK10CL2A"
        );
  }
}

<?php

declare(strict_types=1);

require __DIR__ . '/vendor/autoload.php';

$sumup = new \SumUp\SumUp('sup_sk_your_api_key');

$result = $sumup->members()->delete(
    'MK10CL2A',
    'mem_WZsm7QTPhVrompscmPhoGTXXcrd58fr9MOhP',
);

var_dump($result);

package main

import (
	"context"

	"github.com/sumup/sumup-go"
)

func main() {
	client := sumup.NewClient()
	if err := client.Members.Delete(context.TODO(), "MK10CL2A", "mem_WZsm7QTPhVrompscmPhoGTXXcrd58fr9MOhP"); err != nil {
		panic(err.Error())
	}
}

use sumup::{Authorization, Client};
#[tokio::main]
async fn main() {
    let client = Client::default()
        .with_authorization(Authorization::api_key("sup_sk_test_..."));
    let response = client
        .members()
        .delete("MERCHANT_CODE", "MEMBER_ID")
        .await
        .expect("delete request failed");
    println!("{response:#?}");
}

Response example

{
  "type": "https://developer.sumup.com/problem/forbidden",
  "title": "Forbidden",
  "status": 403,
  "detail": "You do not have permission to perform this action."
}

{
  "type": "https://developer.sumup.com/problem/not-found",
  "title": "Requested resource couldn't be found.",
  "status": 404,
  "detail": "The requested resource doesn't exist or does not belong to you."
}