Delete a Linked Account

DELETEhttps://api.omise.co/linked_accounts/:id

Permanently delete a linked account from your platform. This action is irreversible and the linked account can no longer be used for payments.

---

Request Parameters

Required - 1 fieldRequired Parameters

▼

`id`STRING(required)

Linked Account ID to delete (must be a valid linked account ID starting with lacct_).

Example:"lacct_test_5xuy4w91xqz7d1w9u0t"

Constraints:Must be a valid linked account ID

---

Responses

200

Linked account deleted successfully

Linked account permanently deleted. The account can no longer be used for payments.

Deletion effects:

• Linked account status is set to "deleted"
• Account can no longer process payments
• Registration URI becomes invalid
• Past transactions remain in records
• Deletion cannot be undone

400

Bad request

Invalid linked account ID format.

Common causes:

• Linked account ID format is invalid
• ID does not start with lacct_

401

Unauthorized

Authentication failed. Invalid or missing API key.

Common causes:

• Missing Authorization header
• Invalid secret key
• Using public key instead of secret key
• Incorrect HTTP Basic Auth format

404

Not found

Linked account not found.

Common causes:

• Linked account ID does not exist
• Linked account has already been deleted
• Linked account does not belong to your platform
• Mixing test and live mode IDs

5xx

Server error

Server-side error occurred. These are rare but should be handled gracefully.

How to handle:

• Retry the request with exponential backoff
• Check status.omise.co for service incidents
• See Error Handling for detailed guidance

---

Code samples

cURL

curl https://api.omise.co/linked_accounts/lacct_test_5xuy4w91xqz7d1w9u0t \
  -X DELETE \
  -u skey_test_5xuy4w91xqz7d1w9u0t:

Ruby

require 'omise'

Omise.api_key = 'skey_test_5xuy4w91xqz7d1w9u0t'

linked_account = Omise::LinkedAccount.destroy('lacct_test_5xuy4w91xqz7d1w9u0t')

Python

import omise

omise.api_secret = 'skey_test_5xuy4w91xqz7d1w9u0t'

linked_account = omise.LinkedAccount.retrieve('lacct_test_5xuy4w91xqz7d1w9u0t')
linked_account.destroy()

Node.js

const omise = require('omise')({
  secretKey: 'skey_test_5xuy4w91xqz7d1w9u0t'
});

const linkedAccount = await omise.linkedAccounts.destroy('lacct_test_5xuy4w91xqz7d1w9u0t');

PHP

<?php
define('OMISE_SECRET_KEY', 'skey_test_5xuy4w91xqz7d1w9u0t');

$linked_account = OmiseLinkedAccount::retrieve('lacct_test_5xuy4w91xqz7d1w9u0t');
$linked_account->destroy();

Java

Client client = new Client.Builder()
    .secretKey("skey_test_5xuy4w91xqz7d1w9u0t")
    .build();

LinkedAccount linkedAccount = client.linkedAccounts().destroy("lacct_test_5xuy4w91xqz7d1w9u0t");

C#

var client = new Client("skey_test_5xuy4w91xqz7d1w9u0t");

var linkedAccount = await client.LinkedAccounts.Destroy("lacct_test_5xuy4w91xqz7d1w9u0t");

Go

client, _ := omise.NewClient(
    "pkey_test_5xuy4w91xqz7d1w9u0t",
    "skey_test_5xuy4w91xqz7d1w9u0t",
)

deleted, _ := client.LinkedAccounts().Destroy("lacct_test_5xuy4w91xqz7d1w9u0t")

---

Error and result codes

Common Error Codes

Code	Description	Resolution
bad_request	Invalid linked account ID format	Check ID format
authentication_failure	Invalid API key	Verify your secret key is correct
not_found	Linked account not found	Verify linked account ID exists

Deletion Response

Field	Description
object	Object type (always "linked_account")
id	ID of the deleted linked account
livemode	Whether this was a live mode linked account
status	Status (always "deleted" for successful deletions)
deleted	Boolean flag (always true for successful deletions)

---

🔑API Credentials

▼

Try it out

Required - 1 fields

▼

id(Required)

Your IP: ...Loading...