# 

## Prerequisites

* A valid API key for the client account — see [Obtain API credentials](/docs/how-tos/setup/obtain-credentials)
* The `id` of the integration to update — see [Add an integration](/docs/how-tos/integrations/add-integration)


## What you can update

### TSYS integrations

| Field | Description |
|  --- | --- |
| `general_details.is_active` | Enable or disable the integration |
| `general_details.mid` | TSYS merchant ID |
| `general_details.card_brand` | Primary card brand |
| `general_details.industry_type` | Industry classification |
| `general_details.bin` | BIN number |
| `general_details.url` | TSYS host URL |
| `general_details.settlement_time` | Daily settlement time |
| `agent_details` | Agent/ISO information |
| `metadata` | Custom key-value pairs |


### Vericheck integrations

| Field | Description |
|  --- | --- |
| `business_name` | Legal business name |
| `doing_business_as` | DBA / trade name |
| `website_url` | Business website |
| `addresses` | Business address details |


## Step 1: Retrieve the current integration

Confirm the current state before updating.

```shell
curl https://api.dev.paradisegateway.net/v1/integrations/proc_3MtwBwLkdIwHu7ix28a3tqPa \
  -H "APIKEY: CLIENT-API-KEY"
```

## Step 2: Send the update

Send `POST /v1/integrations/{id}` with the fields to change.

### Example: Update TSYS settlement time and merchant ID

curl
```shell
curl -X POST \
  https://api.dev.paradisegateway.net/v1/integrations/proc_3MtwBwLkdIwHu7ix28a3tqPa \
  -H "Content-Type: application/json" \
  -H "APIKEY: CLIENT-API-KEY" \
  -d '{
    "general_details": {
      "mid": "999000000022",
      "settlement_time": "2026-01-01T23:00:00Z"
    }
  }'
```

Python
```python
import requests

integration_id = "proc_3MtwBwLkdIwHu7ix28a3tqPa"
resp = requests.post(
    f"https://api.dev.paradisegateway.net/v1/integrations/{integration_id}",
    headers={"Content-Type": "application/json", "APIKEY": "CLIENT-API-KEY"},
    json={
        "general_details": {
            "mid": "999000000022",
            "settlement_time": "2026-01-01T23:00:00Z",
        },
    },
)
print(resp.json())
```

JavaScript
```javascript
const id = "proc_3MtwBwLkdIwHu7ix28a3tqPa";
const resp = await fetch(
  `https://api.dev.paradisegateway.net/v1/integrations/${id}`,
  {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      "APIKEY": "CLIENT-API-KEY",
    },
    body: JSON.stringify({
      general_details: {
        mid: "999000000022",
        settlement_time: "2026-01-01T23:00:00Z",
      },
    }),
  }
);
console.log(await resp.json());
```

C#
```csharp
var id = "proc_3MtwBwLkdIwHu7ix28a3tqPa";
var payload = new
{
    general_details = new
    {
        mid = "999000000022",
        settlement_time = "2026-01-01T23:00:00Z"
    }
};
var resp = await client.PostAsJsonAsync(
    $"https://api.dev.paradisegateway.net/v1/integrations/{id}", payload);
Console.WriteLine(await resp.Content.ReadAsStringAsync());
```

Java
```java
String id = "proc_3MtwBwLkdIwHu7ix28a3tqPa";
String body = """
    {
      "general_details": {
        "mid": "999000000022",
        "settlement_time": "2026-01-01T23:00:00Z"
      }
    }
    """;
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create(
        "https://api.dev.paradisegateway.net/v1/integrations/" + id))
    .header("Content-Type", "application/json")
    .header("APIKEY", "CLIENT-API-KEY")
    .POST(HttpRequest.BodyPublishers.ofString(body)).build();
HttpResponse<String> resp = client.send(request,
    HttpResponse.BodyHandlers.ofString());
System.out.println(resp.body());
```

Go
```go
id := "proc_3MtwBwLkdIwHu7ix28a3tqPa"
payload := strings.NewReader(`{
  "general_details": {
    "mid": "999000000022",
    "settlement_time": "2026-01-01T23:00:00Z"
  }
}`)
req, _ := http.NewRequest("POST",
    "https://api.dev.paradisegateway.net/v1/integrations/"+id, payload)
req.Header.Set("Content-Type", "application/json")
req.Header.Set("APIKEY", "CLIENT-API-KEY")
resp, _ := http.DefaultClient.Do(req)
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))
```

PHP
```php
$id = "proc_3MtwBwLkdIwHu7ix28a3tqPa";
$ch = curl_init("https://api.dev.paradisegateway.net/v1/integrations/$id");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true, CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => ["Content-Type: application/json", "APIKEY: CLIENT-API-KEY"],
    CURLOPT_POSTFIELDS => json_encode([
        "general_details" => [
            "mid" => "999000000022",
            "settlement_time" => "2026-01-01T23:00:00Z",
        ],
    ]),
]);
echo curl_exec($ch); curl_close($ch);
```

Ruby
```ruby
require "net/http"; require "json"
id = "proc_3MtwBwLkdIwHu7ix28a3tqPa"
uri = URI("https://api.dev.paradisegateway.net/v1/integrations/#{id}")
req = Net::HTTP::Post.new(uri, {
  "Content-Type" => "application/json", "APIKEY" => "CLIENT-API-KEY",
})
req.body = {
  general_details: {
    mid: "999000000022", settlement_time: "2026-01-01T23:00:00Z",
  },
}.to_json
resp = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(req) }
puts resp.body
```

### Response example

A `200` response returns the full updated integration object.

```json
{
  "id": "proc_3MtwBwLkdIwHu7ix28a3tqPa",
  "object": "processor_account",
  "general_details": {
    "is_active": true,
    "mid": "999000000022",
    "card_brand": "visa",
    "industry_type": "retail",
    "bin": "999995",
    "url": "https://example.tsyshost.com",
    "settlement_time": "2026-01-01T23:00:00Z"
  },
  "metadata": {
    "internal_ref": "tsys-primary"
  },
  "correlation_id": "c3d4e5f6-a7b8-9012-cdef-123456789abc"
}
```

## Deactivate an integration

Set `general_details.is_active` to `false` to stop routing transactions to a processor without deleting the integration.

```shell
curl -X POST \
  https://api.dev.paradisegateway.net/v1/integrations/proc_3MtwBwLkdIwHu7ix28a3tqPa \
  -H "Content-Type: application/json" \
  -H "APIKEY: CLIENT-API-KEY" \
  -d '{ "general_details": { "is_active": false } }'
```

In-flight transactions
Deactivating an integration does not affect transactions already submitted. Pending authorizations and open batches continue to settle normally.

## Next steps

* [Add an integration](/docs/how-tos/integrations/add-integration)
* [About supported processors](/docs/get-started/supported-processors)
* [Close a batch manually](/docs/how-tos/manage-transactions/close-batch-manually)