---
updatedAt: 2026-09-25T12:56:21.000Z
agentTools:
  projectIndex: https://docs.transfi.com/llms.txt
---

# Delete Settlement Account

Deletes a settlement account. A default settlement account cannot be deleted — another account needs to be set as default before deleting current default account.

# OpenAPI definition

```json
{
  "components": {
    "securitySchemes": {
      "basicAuth": {
        "description": "",
        "scheme": "basic",
        "type": "http"
      }
    }
  },
  "x-stoplight": {
    "id": "v9366inl1ssr3"
  },
  "info": {
    "contact": {
      "email": "support@transfi.com",
      "name": "Transfi Developer Support",
      "url": "https://transfi.com"
    },
    "description": "Access state of the art crypto payment rails easily using TransFi's API",
    "license": {
      "name": "Proprietary",
      "url": "https://transfi.com"
    },
    "summary": "TransFi Single Integrated API",
    "title": "TransFi Single Integrated API",
    "version": "3.0"
  },
  "openapi": "3.1.0",
  "security": [
    {
      "basicAuth": []
    }
  ],
  "servers": [
    {
      "description": "Sandbox Server",
      "url": "https://sandbox-api.transfi.com"
    }
  ],
  "tags": [
    {
      "name": "Settlement Accounts",
      "description": "Create and list fiat and crypto settlement accounts for payouts."
    }
  ],
  "paths": {
    "/v3/settlement-account/{settlementAccountId}": {
      "delete": {
        "summary": "Delete Settlement Account",
        "description": "Deletes a settlement account. A default settlement account cannot be deleted — another account needs to be set as default before deleting current default account.",
        "operationId": "delete-settlement-account",
        "parameters": [
          {
            "in": "header",
            "name": "MID",
            "description": "Merchant or sub-merchant MID",
            "required": true,
            "schema": {
              "type": "string",
              "example": "SABCDEF_SCT8YW_NA"
            }
          },
          {
            "in": "path",
            "name": "settlementAccountId",
            "description": "The ID of the settlement account to delete",
            "required": true,
            "schema": {
              "type": "string",
              "example": "SA-123456789"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Settlement account deleted successfully",
            "content": {
              "application/json": {
                "examples": {
                  "success": {
                    "value": {
                      "status": "success",
                      "message": "Settlement account deleted successfully",
                      "data": {
                        "settlementAccountId": "SA-123456789"
                      }
                    }
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "status": {
                      "type": "string"
                    },
                    "message": {
                      "type": "string"
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "settlementAccountId": {
                          "type": "string"
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Validation error",
            "content": {
              "application/json": {
                "examples": {
                  "default_cannot_be_deleted": {
                    "summary": "Cannot delete the default account",
                    "value": {
                      "status": "failure",
                      "error": {
                        "message": "This is a default settlement account, please make another account as default before deleting this account",
                        "code": "VALIDATION_ERROR",
                        "context": {
                          "details": [
                            {
                              "field": "settlementAccountId",
                              "message": "This is a default settlement account, please make another account as default before deleting this account",
                              "code": "DEFAULT_SETTLEMENT_ACCOUNT_CANNOT_BE_DELETED"
                            }
                          ]
                        }
                      },
                      "errorId": "8043330a-80d0-4b39-ab60-5f481d9e5757"
                    }
                  },
                  "not_found": {
                    "summary": "Settlement account not found",
                    "value": {
                      "status": "failure",
                      "error": {
                        "message": "Settlement account not found",
                        "code": "VALIDATION_ERROR",
                        "context": {
                          "details": [
                            {
                              "field": "settlementAccountId",
                              "message": "Settlement account not found",
                              "code": "SETTLEMENT_ACCOUNT_NOT_FOUND"
                            }
                          ]
                        }
                      },
                      "errorId": "8043330a-80d0-4b39-ab60-5f481d9e5757"
                    }
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "status": {
                      "type": "string"
                    },
                    "error": {
                      "type": "object",
                      "properties": {
                        "message": {
                          "type": "string"
                        },
                        "code": {
                          "type": "string"
                        },
                        "context": {
                          "type": "object",
                          "properties": {
                            "details": {
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "field": {
                                    "type": "string"
                                  },
                                  "message": {
                                    "type": "string"
                                  },
                                  "code": {
                                    "type": "string"
                                  }
                                }
                              }
                            }
                          }
                        }
                      }
                    },
                    "errorId": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "examples": {
                  "server_error": {
                    "value": {
                      "message": "Service unavailable",
                      "code": "SERVICE_ERROR"
                    }
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "status": {
                      "type": "string"
                    },
                    "message": {
                      "type": "string"
                    },
                    "code": {
                      "type": "string"
                    },
                    "error": {
                      "type": "object",
                      "properties": {
                        "message": {
                          "type": "string"
                        },
                        "code": {
                          "type": "string"
                        }
                      }
                    },
                    "errorId": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "Settlement Accounts"
        ],
        "security": [
          {
            "basicAuth": []
          }
        ],
        "x-stoplight": {
          "id": "eoa4f1qcfb1u5"
        }
      }
    }
  }
}
```