Delete Customer

Delete a customer record.

Deletes a customer record. This is a hard delete — the customer row is permanently removed from the database (customerRepo.delete(...)), not soft-deleted.

A customer can only be deleted if they have no associated transactions. If the customer has any transactions (on-ramp or off-ramp), the delete will fail.

Endpoint

DELETE /v1/customers/:prop

Authentication

Accepts either a merchant API key or a business-user JWT.

Header	Value
Authorization	<api_key> or Bearer <jwt>

Path parameters

Parameter	Type	Description
prop	string	Customer UUID, email address, or refCode

Example request

cURL

curl -X DELETE https://ramp-api.ivorypay.io/api/v1/customers/[e-mail] \
  -H "Authorization: your_api_key"

Node.js

const response = await fetch("https://ramp-api.ivorypay.io/api/v1/customers/[e-mail]", {
  method: "DELETE",
  headers: {
    "Authorization": "your_api_key",
  },
});

const data = await response.json();
console.log(data);

Python

import requests

response = requests.delete(
    "https://ramp-api.ivorypay.io/api/v1/customers/[e-mail]",
    headers={
        "Authorization": "your_api_key",
    },
)

print(response.json())

Go

package main

import (
	"fmt"
	"io"
	"net/http"
)

func main() {
	req, _ := http.NewRequest("DELETE", "https://ramp-api.ivorypay.io/api/v1/customers/[e-mail]", nil)
	req.Header.Set("Authorization", "your_api_key")

	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()

	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}

Example response

{
  "success": true,
  "message": "Customer was removed successfully"
}

Error cases

Scenario	Description
Customer has transactions	Cannot delete — customer has associated transaction history
Customer not found	No customer exists with the given identifier