Skip to content
Last updated

Update processor credentials

Prerequisites

What you can update

TSYS integrations

FieldDescription
general_details.is_activeEnable or disable the integration
general_details.midTSYS merchant ID
general_details.card_brandPrimary card brand
general_details.industry_typeIndustry classification
general_details.binBIN number
general_details.urlTSYS host URL
general_details.settlement_timeDaily settlement time
agent_detailsAgent/ISO information
metadataCustom key-value pairs

Vericheck integrations

FieldDescription
business_nameLegal business name
doing_business_asDBA / trade name
website_urlBusiness website
addressesBusiness address details

Step 1: Retrieve the current integration

Confirm the current state before updating.

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 -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"
    }
  }'

Response example

A 200 response returns the full updated integration object.

{
  "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.

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