{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-docs/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["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":"about-clients-and-resellers","__idx":0},"children":["About clients and resellers"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"account-model","__idx":1},"children":["Account model"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Reefpay"," organizes accounts as ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["clients"]},". Each client has a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["type"]}," that determines its role in the hierarchy."]},{"$$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":"Client type"},"children":["Client type"]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Description"},"children":["Description"]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Can process transactions"},"children":["Can process transactions"]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Can manage sub-accounts"},"children":["Can manage sub-accounts"]}]}]},{"$$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":["reseller"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["An organization that onboards and manages merchants (ISOs, agents, acquirers, payment facilitators)"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["No (transactions flow through merchant children)"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Yes"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["merchant"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["A business that processes payments through ","Reefpay"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["No"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Every client has:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A unique ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["id"]}," (for example, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CLIENT-3MtwBwLkdIwHu7ix28a3tqPa"]},")"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["parent_id"]}," that links it to its parent in the hierarchy"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["dba"]}," (doing-business-as) name"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Admin contact details"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"hierarchy-structure","__idx":2},"children":["Hierarchy structure"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The hierarchy is a tree. Resellers sit above merchants and can have other resellers as children, enabling multi-level distribution models."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"https://files.modern-mermaid.live/images/1776271376268-mermaid-diagram-1776271376228.png","alt":"image"},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"how-parent_id-works","__idx":3},"children":["How ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["parent_id"]}," works"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Each client's ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["parent_id"]}," points to the client directly above it in the tree."]},{"$$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":"Client"},"children":["Client"]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"parent_id"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["parent_id"]}]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Reseller A"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["reseller"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Platform root"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Merchant 1"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["merchant"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Reseller A"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Sub-reseller"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["reseller"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Reseller A"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Merchant 3"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["merchant"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Sub-reseller"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A reseller can view and manage all clients beneath it in the tree — including clients under its sub-resellers."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"merchants","__idx":4},"children":["Merchants"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A merchant is a business entity that processes payment transactions. Each merchant has:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["One or more ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["MIDs"]}," (Merchant Identification Numbers) assigned by the processor"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Integrations"]}," with payment processors (TSYS for cards, Vericheck for ACH)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Users"]}," who can access the API and web portal"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Payment tokens"]}," scoped to that merchant"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Batches"]}," and ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["transactions"]}," associated with their MIDs"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Merchants are always leaf nodes in the hierarchy — they cannot have child accounts."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"resellers","__idx":5},"children":["Resellers"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A reseller is an organization that onboards, manages, and supports merchants. Resellers can:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Create merchant accounts"]}," under their hierarchy"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Create sub-resellers"]}," for multi-level distribution"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["View transactions and reports"]}," across all merchants in their tree"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Manage users"]}," for their own account and child accounts"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Configure integrations"]}," for child merchants"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Resellers do not process transactions directly. All payment processing happens at the merchant level."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"creating-a-client","__idx":6},"children":["Creating a client"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Create a new client (merchant or reseller) with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /v1/clients"]},"."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"POST /v1/clients\n\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","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"required-fields","__idx":7},"children":["Required fields"]},{"$$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":["dba"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Business name (1–100 characters)"]}]},{"$$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":["ID of the parent client (reseller)"]}]},{"$$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":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["merchant"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["reseller"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["admin_contact_details"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Contact information including ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["first_name"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["last_name"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["email"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["phone"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["time_zone"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Who can create clients"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Only reseller accounts (or platform administrators) can create child clients. A merchant cannot create sub-accounts."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"managing-clients","__idx":8},"children":["Managing clients"]},{"$$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":"Operation"},"children":["Operation"]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Endpoint"},"children":["Endpoint"]},{"$$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":["Create"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /v1/clients"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Create a merchant or reseller"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["List"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /v1/clients"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["List all clients in your hierarchy"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Retrieve"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /v1/clients/{id}"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Get details for a specific client"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Update"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /v1/clients/{id}"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Update client details (DBA name, contact info)"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"integrations","__idx":9},"children":["Integrations"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Before a merchant can process transactions, it must have at least one ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["integration"]}," with a payment processor."]},{"$$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":"Processor"},"children":["Processor"]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Integration type"},"children":["Integration type"]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Payment types"},"children":["Payment types"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["TSYS"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Card processing"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Credit/debit card sales, authorizations, captures, cancels, refunds"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Vericheck"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["ACH processing"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Bank account payments, payouts, cancels"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Integrations are created with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /v1/integrations"]}," and are scoped to a specific client. Each integration provides the processor credentials (MID, terminal ID) needed for transaction routing."]},{"$$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":"data-isolation","__idx":10},"children":["Data isolation"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Reefpay"," enforces strict data isolation between clients."]},{"$$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":"Scope"},"children":["Scope"]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Rule"},"children":["Rule"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Transactions"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Visible only to the merchant that processed them and its parent resellers"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Payment tokens"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Scoped to the merchant MID — cannot be used across merchants"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["API keys"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Authenticate to a specific client — cannot access other clients' data"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Users"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Belong to a single client; reseller users can access child client data"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Batches"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Contain only transactions from the associated merchant"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"common-patterns","__idx":11},"children":["Common patterns"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"payment-facilitator-payfac","__idx":12},"children":["Payment facilitator (PayFac)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A PayFac registers as a reseller and onboards sub-merchants under its account. The PayFac manages compliance and settlement, while each sub-merchant has its own MID and transaction history."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"iso--agent-model","__idx":13},"children":["ISO / agent model"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["An Independent Sales Organization (ISO) or agent registers as a reseller to manage a portfolio of merchants. The ISO can view aggregate reporting across all merchants and manage their integrations."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"direct-merchant","__idx":14},"children":["Direct merchant"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A merchant that integrates directly with ","Reefpay"," (no reseller) has its ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["parent_id"]}," set to the platform root."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"further-reading","__idx":15},"children":["Further reading"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/concepts/account-hierarchy/users-and-roles"},"children":["About users and roles"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/get-started/supported-processors"},"children":["Supported processors"]}]}]}]},"headings":[{"value":"About clients and resellers","id":"about-clients-and-resellers","depth":1},{"value":"Account model","id":"account-model","depth":2},{"value":"Hierarchy structure","id":"hierarchy-structure","depth":2},{"value":"How parent_id works","id":"how-parent_id-works","depth":3},{"value":"Merchants","id":"merchants","depth":2},{"value":"Resellers","id":"resellers","depth":2},{"value":"Creating a client","id":"creating-a-client","depth":2},{"value":"Required fields","id":"required-fields","depth":3},{"value":"Managing clients","id":"managing-clients","depth":2},{"value":"Integrations","id":"integrations","depth":2},{"value":"Data isolation","id":"data-isolation","depth":2},{"value":"Common patterns","id":"common-patterns","depth":2},{"value":"Payment facilitator (PayFac)","id":"payment-facilitator-payfac","depth":3},{"value":"ISO / agent model","id":"iso--agent-model","depth":3},{"value":"Direct merchant","id":"direct-merchant","depth":3},{"value":"Further reading","id":"further-reading","depth":2}],"frontmatter":{"title":"About clients and resellers","shortTitle":"Clients and resellers","intro":"{% $env.PUBLIC_BRAND_NAME %} uses a multi-tenant client hierarchy. Every account is a client — either a merchant that processes payments or a reseller that manages merchants. Understanding this structure is essential for account provisioning and access control.","type":"overview","seo":{"title":""}},"lastModified":"2026-06-05T02:46:44.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/docs/concepts/account-hierarchy/clients-and-resellers","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}