{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-docs/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["tabs","tab"]},"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":"create-a-client-account","__idx":0},"children":["Create a client account"]},{"$$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":["An existing reseller account with admin credentials (resellers create child accounts)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A valid API key with admin permissions — see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/how-tos/setup/obtain-credentials"},"children":["Obtain API credentials"]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-1-prepare-account-details","__idx":2},"children":["Step 1: Prepare account details"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Gather the following information for the new client."]},{"$$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":"Required"},"children":["Required"]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Description"},"children":["Description"]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Example"},"children":["Example"]}]}]},{"$$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":["dba"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Business name (doing-business-as)"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Acme Jewelry"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["parent_id"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Your reseller client ID"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CLIENT-01JMRSPCK7XVNP3KS8F2W4T6Y"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["type"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["merchant"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["reseller"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["merchant"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["admin_contact_details.first_name"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Admin's first name"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["John"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["admin_contact_details.last_name"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Admin's last name"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Doe"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["admin_contact_details.email"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Admin's email address"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["john.doe@example.com"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["admin_contact_details.phone"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Admin's phone number"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["+15551234567"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["admin_contact_details.time_zone"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Time zone"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["America/New_York"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Supported time zones: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["America/Los_Angeles"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["America/Phoenix"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["America/Denver"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["America/Chicago"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["America/New_York"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Pacific/Honolulu"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["America/Anchorage"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-2-create-the-client","__idx":3},"children":["Step 2: Create the client"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Send a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST"]}," request to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/v1/clients"]},"."]},{"$$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/clients \\\n  -H \"Content-Type: application/json\" \\\n  -H \"APIKEY: YOUR-API-KEY\" \\\n  -d '{\n    \"dba\": \"Acme Jewelry\",\n    \"parent_id\": \"CLIENT-01JMRSPCK7XVNP3KS8F2W4T6Y\",\n    \"type\": \"merchant\",\n    \"admin_contact_details\": {\n      \"first_name\": \"John\",\n      \"last_name\": \"Doe\",\n      \"email\": \"john.doe@example.com\",\n      \"phone\": \"+15551234567\",\n      \"time_zone\": \"America/New_York\"\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\nresp = requests.post(\n    \"https://api.dev.paradisegateway.net/v1/clients\",\n    headers={\n        \"Content-Type\": \"application/json\",\n        \"APIKEY\": \"YOUR-API-KEY\",\n    },\n    json={\n        \"dba\": \"Acme Jewelry\",\n        \"parent_id\": \"CLIENT-01JMRSPCK7XVNP3KS8F2W4T6Y\",\n        \"type\": \"merchant\",\n        \"admin_contact_details\": {\n            \"first_name\": \"John\",\n            \"last_name\": \"Doe\",\n            \"email\": \"john.doe@example.com\",\n            \"phone\": \"+15551234567\",\n            \"time_zone\": \"America/New_York\",\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 resp = await fetch(\n  \"https://api.dev.paradisegateway.net/v1/clients\",\n  {\n    method: \"POST\",\n    headers: {\n      \"Content-Type\": \"application/json\",\n      \"APIKEY\": \"YOUR-API-KEY\",\n    },\n    body: JSON.stringify({\n      dba: \"Acme Jewelry\",\n      parent_id: \"CLIENT-01JMRSPCK7XVNP3KS8F2W4T6Y\",\n      type: \"merchant\",\n      admin_contact_details: {\n        first_name: \"John\",\n        last_name: \"Doe\",\n        email: \"john.doe@example.com\",\n        phone: \"+15551234567\",\n        time_zone: \"America/New_York\",\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":"using var client = new HttpClient();\nclient.DefaultRequestHeaders.Add(\"APIKEY\", \"YOUR-API-KEY\");\n\nvar payload = new\n{\n    dba = \"Acme Jewelry\",\n    parent_id = \"CLIENT-01JMRSPCK7XVNP3KS8F2W4T6Y\",\n    type = \"merchant\",\n    admin_contact_details = new\n    {\n        first_name = \"John\",\n        last_name = \"Doe\",\n        email = \"john.doe@example.com\",\n        phone = \"+15551234567\",\n        time_zone = \"America/New_York\"\n    }\n};\n\nvar resp = await client.PostAsJsonAsync(\n    \"https://api.dev.paradisegateway.net/v1/clients\", 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":"HttpClient client = HttpClient.newHttpClient();\nString body = \"\"\"\n    {\n      \"dba\": \"Acme Jewelry\",\n      \"parent_id\": \"CLIENT-01JMRSPCK7XVNP3KS8F2W4T6Y\",\n      \"type\": \"merchant\",\n      \"admin_contact_details\": {\n        \"first_name\": \"John\",\n        \"last_name\": \"Doe\",\n        \"email\": \"john.doe@example.com\",\n        \"phone\": \"+15551234567\",\n        \"time_zone\": \"America/New_York\"\n      }\n    }\n    \"\"\";\nHttpRequest request = HttpRequest.newBuilder()\n    .uri(URI.create(\"https://api.dev.paradisegateway.net/v1/clients\"))\n    .header(\"Content-Type\", \"application/json\")\n    .header(\"APIKEY\", \"YOUR-API-KEY\")\n    .POST(HttpRequest.BodyPublishers.ofString(body))\n    .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":"payload := strings.NewReader(`{\n  \"dba\": \"Acme Jewelry\",\n  \"parent_id\": \"CLIENT-01JMRSPCK7XVNP3KS8F2W4T6Y\",\n  \"type\": \"merchant\",\n  \"admin_contact_details\": {\n    \"first_name\": \"John\",\n    \"last_name\": \"Doe\",\n    \"email\": \"john.doe@example.com\",\n    \"phone\": \"+15551234567\",\n    \"time_zone\": \"America/New_York\"\n  }\n}`)\nreq, _ := http.NewRequest(\"POST\",\n    \"https://api.dev.paradisegateway.net/v1/clients\", payload)\nreq.Header.Set(\"Content-Type\", \"application/json\")\nreq.Header.Set(\"APIKEY\", \"YOUR-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":"$ch = curl_init(\"https://api.dev.paradisegateway.net/v1/clients\");\ncurl_setopt_array($ch, [\n    CURLOPT_RETURNTRANSFER => true,\n    CURLOPT_POST => true,\n    CURLOPT_HTTPHEADER => [\n        \"Content-Type: application/json\",\n        \"APIKEY: YOUR-API-KEY\",\n    ],\n    CURLOPT_POSTFIELDS => json_encode([\n        \"dba\" => \"Acme Jewelry\",\n        \"parent_id\" => \"CLIENT-01JMRSPCK7XVNP3KS8F2W4T6Y\",\n        \"type\" => \"merchant\",\n        \"admin_contact_details\" => [\n            \"first_name\" => \"John\",\n            \"last_name\" => \"Doe\",\n            \"email\" => \"john.doe@example.com\",\n            \"phone\" => \"+15551234567\",\n            \"time_zone\" => \"America/New_York\",\n        ],\n    ]),\n]);\necho curl_exec($ch);\ncurl_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\"\nrequire \"json\"\n\nuri = URI(\"https://api.dev.paradisegateway.net/v1/clients\")\nreq = Net::HTTP::Post.new(uri, {\n  \"Content-Type\" => \"application/json\",\n  \"APIKEY\" => \"YOUR-API-KEY\",\n})\nreq.body = {\n  dba: \"Acme Jewelry\",\n  parent_id: \"CLIENT-01JMRSPCK7XVNP3KS8F2W4T6Y\",\n  type: \"merchant\",\n  admin_contact_details: {\n    first_name: \"John\",\n    last_name: \"Doe\",\n    email: \"john.doe@example.com\",\n    phone: \"+15551234567\",\n    time_zone: \"America/New_York\",\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":2,"id":"step-3-verify-the-response","__idx":4},"children":["Step 3: Verify the response"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A successful request returns a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["200"]}," response with the new client object."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"id\": \"CLIENT-04MQACMEJWLRY8NP3KS2W6X9Z\",\n  \"object\": \"client\",\n  \"parent_id\": \"CLIENT-01JMRSPCK7XVNP3KS8F2W4T6Y\",\n  \"dba\": \"Acme Jewelry\",\n  \"type\": \"merchant\",\n  \"admin_contact_details\": {\n    \"first_name\": \"John\",\n    \"last_name\": \"Doe\",\n    \"email\": \"john.doe@example.com\",\n    \"phone\": \"+15551234567\",\n    \"time_zone\": \"America/New_York\"\n  },\n  \"correlation_id\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Save the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["id"]}," value — you need it for creating users, integrations, and API keys under this client."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-4-create-a-processor-integration","__idx":5},"children":["Step 4: Create a processor integration"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Before the new merchant can process transactions, connect it to a payment processor with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /v1/integrations"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For more information, see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/get-started/supported-processors"},"children":["Supported processors"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-5-create-an-admin-user","__idx":6},"children":["Step 5: Create an admin user"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Create a user account for the new client so someone can log in and manage it. See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/how-tos/setup/obtain-credentials"},"children":["Obtain API credentials"]}," for details on creating users and retrieving API keys."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"next-steps","__idx":7},"children":["Next steps"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/how-tos/setup/obtain-credentials"},"children":["Obtain API credentials"]}," — generate API keys for the new account"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/how-tos/setup/setup-sandbox-env"},"children":["Set up a sandbox environment"]}," — configure test credentials"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/concepts/account-hierarchy/clients-and-resellers"},"children":["About clients and resellers"]}," — understand the account hierarchy"]}]}]},"headings":[{"value":"Create a client account","id":"create-a-client-account","depth":1},{"value":"Prerequisites","id":"prerequisites","depth":2},{"value":"Step 1: Prepare account details","id":"step-1-prepare-account-details","depth":2},{"value":"Step 2: Create the client","id":"step-2-create-the-client","depth":2},{"value":"Step 3: Verify the response","id":"step-3-verify-the-response","depth":2},{"value":"Step 4: Create a processor integration","id":"step-4-create-a-processor-integration","depth":2},{"value":"Step 5: Create an admin user","id":"step-5-create-an-admin-user","depth":2},{"value":"Next steps","id":"next-steps","depth":2}],"frontmatter":{"title":"Create a client account","shortTitle":"Create a client account","intro":"Register a new merchant or reseller account in {% $env.PUBLIC_BRAND_NAME %}, assign admin contact details, and verify the account is active.","type":"how-to","seo":{"title":""}},"lastModified":"2026-06-05T02:46:44.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/docs/how-tos/setup/create-client-account","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}