{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-docs/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["tabs","tab","admonition"]},"type":"markdown"},"seo":{"title":"Reefpay Docs","description":"Reefpay is the groundbreaking payment gateway that lets you integrate with the future of payments.","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"update-processor-credentials","__idx":0},"children":["Update processor credentials"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"prerequisites","__idx":1},"children":["Prerequisites"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A valid API key for the client account — see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/how-tos/setup/obtain-credentials"},"children":["Obtain API credentials"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["id"]}," of the integration to update — see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/how-tos/integrations/add-integration"},"children":["Add an integration"]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"what-you-can-update","__idx":2},"children":["What you can update"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"tsys-integrations","__idx":3},"children":["TSYS integrations"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Field"},"children":["Field"]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["general_details.is_active"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Enable or disable the integration"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["general_details.mid"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["TSYS merchant ID"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["general_details.card_brand"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Primary card brand"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["general_details.industry_type"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Industry classification"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["general_details.bin"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["BIN number"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["general_details.url"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["TSYS host URL"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["general_details.settlement_time"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Daily settlement time"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["agent_details"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Agent/ISO information"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["metadata"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Custom key-value pairs"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"vericheck-integrations","__idx":4},"children":["Vericheck integrations"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Field"},"children":["Field"]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["business_name"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Legal business name"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["doing_business_as"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["DBA / trade name"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["website_url"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Business website"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["addresses"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Business address details"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-1-retrieve-the-current-integration","__idx":5},"children":["Step 1: Retrieve the current integration"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Confirm the current state before updating."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"shell","header":{"controls":{"copy":{}}},"source":"curl https://api.dev.paradisegateway.net/v1/integrations/proc_3MtwBwLkdIwHu7ix28a3tqPa \\\n  -H \"APIKEY: CLIENT-API-KEY\"\n","lang":"shell"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-2-send-the-update","__idx":6},"children":["Step 2: Send the update"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Send ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /v1/integrations/{id}"]}," with the fields to change."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"example-update-tsys-settlement-time-and-merchant-id","__idx":7},"children":["Example: Update TSYS settlement time and merchant ID"]},{"$$mdtype":"Tag","name":"Tabs","attributes":{"size":"medium"},"children":[{"$$mdtype":"Tag","name":"TabItemFragment","attributes":{"label":"curl","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"shell","header":{"controls":{"copy":{}}},"source":"curl -X POST \\\n  https://api.dev.paradisegateway.net/v1/integrations/proc_3MtwBwLkdIwHu7ix28a3tqPa \\\n  -H \"Content-Type: application/json\" \\\n  -H \"APIKEY: CLIENT-API-KEY\" \\\n  -d '{\n    \"general_details\": {\n      \"mid\": \"999000000022\",\n      \"settlement_time\": \"2026-01-01T23:00:00Z\"\n    }\n  }'\n","lang":"shell"},"children":[]}]},{"$$mdtype":"Tag","name":"TabItemFragment","attributes":{"label":"Python","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"python","header":{"controls":{"copy":{}}},"source":"import requests\n\nintegration_id = \"proc_3MtwBwLkdIwHu7ix28a3tqPa\"\nresp = requests.post(\n    f\"https://api.dev.paradisegateway.net/v1/integrations/{integration_id}\",\n    headers={\"Content-Type\": \"application/json\", \"APIKEY\": \"CLIENT-API-KEY\"},\n    json={\n        \"general_details\": {\n            \"mid\": \"999000000022\",\n            \"settlement_time\": \"2026-01-01T23:00:00Z\",\n        },\n    },\n)\nprint(resp.json())\n","lang":"python"},"children":[]}]},{"$$mdtype":"Tag","name":"TabItemFragment","attributes":{"label":"JavaScript","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"javascript","header":{"controls":{"copy":{}}},"source":"const id = \"proc_3MtwBwLkdIwHu7ix28a3tqPa\";\nconst resp = await fetch(\n  `https://api.dev.paradisegateway.net/v1/integrations/${id}`,\n  {\n    method: \"POST\",\n    headers: {\n      \"Content-Type\": \"application/json\",\n      \"APIKEY\": \"CLIENT-API-KEY\",\n    },\n    body: JSON.stringify({\n      general_details: {\n        mid: \"999000000022\",\n        settlement_time: \"2026-01-01T23:00:00Z\",\n      },\n    }),\n  }\n);\nconsole.log(await resp.json());\n","lang":"javascript"},"children":[]}]},{"$$mdtype":"Tag","name":"TabItemFragment","attributes":{"label":"C#","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"csharp","header":{"controls":{"copy":{}}},"source":"var id = \"proc_3MtwBwLkdIwHu7ix28a3tqPa\";\nvar payload = new\n{\n    general_details = new\n    {\n        mid = \"999000000022\",\n        settlement_time = \"2026-01-01T23:00:00Z\"\n    }\n};\nvar resp = await client.PostAsJsonAsync(\n    $\"https://api.dev.paradisegateway.net/v1/integrations/{id}\", payload);\nConsole.WriteLine(await resp.Content.ReadAsStringAsync());\n","lang":"csharp"},"children":[]}]},{"$$mdtype":"Tag","name":"TabItemFragment","attributes":{"label":"Java","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"java","header":{"controls":{"copy":{}}},"source":"String id = \"proc_3MtwBwLkdIwHu7ix28a3tqPa\";\nString body = \"\"\"\n    {\n      \"general_details\": {\n        \"mid\": \"999000000022\",\n        \"settlement_time\": \"2026-01-01T23:00:00Z\"\n      }\n    }\n    \"\"\";\nHttpRequest request = HttpRequest.newBuilder()\n    .uri(URI.create(\n        \"https://api.dev.paradisegateway.net/v1/integrations/\" + id))\n    .header(\"Content-Type\", \"application/json\")\n    .header(\"APIKEY\", \"CLIENT-API-KEY\")\n    .POST(HttpRequest.BodyPublishers.ofString(body)).build();\nHttpResponse<String> resp = client.send(request,\n    HttpResponse.BodyHandlers.ofString());\nSystem.out.println(resp.body());\n","lang":"java"},"children":[]}]},{"$$mdtype":"Tag","name":"TabItemFragment","attributes":{"label":"Go","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"go","header":{"controls":{"copy":{}}},"source":"id := \"proc_3MtwBwLkdIwHu7ix28a3tqPa\"\npayload := strings.NewReader(`{\n  \"general_details\": {\n    \"mid\": \"999000000022\",\n    \"settlement_time\": \"2026-01-01T23:00:00Z\"\n  }\n}`)\nreq, _ := http.NewRequest(\"POST\",\n    \"https://api.dev.paradisegateway.net/v1/integrations/\"+id, payload)\nreq.Header.Set(\"Content-Type\", \"application/json\")\nreq.Header.Set(\"APIKEY\", \"CLIENT-API-KEY\")\nresp, _ := http.DefaultClient.Do(req)\ndefer resp.Body.Close()\nbody, _ := io.ReadAll(resp.Body)\nfmt.Println(string(body))\n","lang":"go"},"children":[]}]},{"$$mdtype":"Tag","name":"TabItemFragment","attributes":{"label":"PHP","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"php","header":{"controls":{"copy":{}}},"source":"$id = \"proc_3MtwBwLkdIwHu7ix28a3tqPa\";\n$ch = curl_init(\"https://api.dev.paradisegateway.net/v1/integrations/$id\");\ncurl_setopt_array($ch, [\n    CURLOPT_RETURNTRANSFER => true, CURLOPT_POST => true,\n    CURLOPT_HTTPHEADER => [\"Content-Type: application/json\", \"APIKEY: CLIENT-API-KEY\"],\n    CURLOPT_POSTFIELDS => json_encode([\n        \"general_details\" => [\n            \"mid\" => \"999000000022\",\n            \"settlement_time\" => \"2026-01-01T23:00:00Z\",\n        ],\n    ]),\n]);\necho curl_exec($ch); curl_close($ch);\n","lang":"php"},"children":[]}]},{"$$mdtype":"Tag","name":"TabItemFragment","attributes":{"label":"Ruby","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"ruby","header":{"controls":{"copy":{}}},"source":"require \"net/http\"; require \"json\"\nid = \"proc_3MtwBwLkdIwHu7ix28a3tqPa\"\nuri = URI(\"https://api.dev.paradisegateway.net/v1/integrations/#{id}\")\nreq = Net::HTTP::Post.new(uri, {\n  \"Content-Type\" => \"application/json\", \"APIKEY\" => \"CLIENT-API-KEY\",\n})\nreq.body = {\n  general_details: {\n    mid: \"999000000022\", settlement_time: \"2026-01-01T23:00:00Z\",\n  },\n}.to_json\nresp = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(req) }\nputs resp.body\n","lang":"ruby"},"children":[]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"response-example","__idx":8},"children":["Response example"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["200"]}," response returns the full updated integration object."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"id\": \"proc_3MtwBwLkdIwHu7ix28a3tqPa\",\n  \"object\": \"processor_account\",\n  \"general_details\": {\n    \"is_active\": true,\n    \"mid\": \"999000000022\",\n    \"card_brand\": \"visa\",\n    \"industry_type\": \"retail\",\n    \"bin\": \"999995\",\n    \"url\": \"https://example.tsyshost.com\",\n    \"settlement_time\": \"2026-01-01T23:00:00Z\"\n  },\n  \"metadata\": {\n    \"internal_ref\": \"tsys-primary\"\n  },\n  \"correlation_id\": \"c3d4e5f6-a7b8-9012-cdef-123456789abc\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"deactivate-an-integration","__idx":9},"children":["Deactivate an integration"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Set ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["general_details.is_active"]}," to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["false"]}," to stop routing transactions to a processor without deleting the integration."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"shell","header":{"controls":{"copy":{}}},"source":"curl -X POST \\\n  https://api.dev.paradisegateway.net/v1/integrations/proc_3MtwBwLkdIwHu7ix28a3tqPa \\\n  -H \"Content-Type: application/json\" \\\n  -H \"APIKEY: CLIENT-API-KEY\" \\\n  -d '{ \"general_details\": { \"is_active\": false } }'\n","lang":"shell"},"children":[]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning","name":"In-flight transactions"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Deactivating an integration does not affect transactions already submitted. Pending authorizations and open batches continue to settle normally."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"next-steps","__idx":10},"children":["Next steps"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/how-tos/integrations/add-integration"},"children":["Add an integration"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/get-started/supported-processors"},"children":["About supported processors"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/how-tos/manage-transactions/close-batch-manually"},"children":["Close a batch manually"]}]}]}]},"headings":[{"value":"Update processor credentials","id":"update-processor-credentials","depth":1},{"value":"Prerequisites","id":"prerequisites","depth":2},{"value":"What you can update","id":"what-you-can-update","depth":2},{"value":"TSYS integrations","id":"tsys-integrations","depth":3},{"value":"Vericheck integrations","id":"vericheck-integrations","depth":3},{"value":"Step 1: Retrieve the current integration","id":"step-1-retrieve-the-current-integration","depth":2},{"value":"Step 2: Send the update","id":"step-2-send-the-update","depth":2},{"value":"Example: Update TSYS settlement time and merchant ID","id":"example-update-tsys-settlement-time-and-merchant-id","depth":3},{"value":"Response example","id":"response-example","depth":3},{"value":"Deactivate an integration","id":"deactivate-an-integration","depth":2},{"value":"Next steps","id":"next-steps","depth":2}],"frontmatter":{"title":"Update processor credentials","shortTitle":"Update integration","intro":"Modify the configuration of an existing integration — for example, change a TSYS merchant ID, update a settlement time, or deactivate a processor connection.","type":"how-to","seo":{"title":""}},"lastModified":"2026-06-05T02:46:44.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/docs/how-tos/integrations/update-integration","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}