Create a New Merchant

New Merchant Object

We collect essential legal information (business name, address, and tax ID) to verify your business legitimacy and establish a unique merchant identifier. This is the details about the business.

{
  "legal": {
    "name": "Prahsys Test",
    "dba": "Ethan Prahsys test",
    "locationName": "Main Location",
    "taxId": "666989898",
    "address": {
      "street1": "500 S Main Street",
      "city": "Spokane",
      "state": "WA",
      "zipCode": "99206"
    },
    "mailingAddressSameAsBusinessAddress": true,
    "ownershipType": "CORPORATION",
    "category": "RETAIL",
    "productsSold": "Test Products",
    "phone": "+12234567890",
    "email": "[email protected]",
    "dateOfIncorporation": "2020-01-01T00:00:00.000Z",
    "website": "https://test.com",
    "averageTicketPrice": 100,
    "highTicketPrice": 500,
    "averageMonthlyVolume": 10000,
    "b2bTransactionPercentage": 60,
    "b2cTransactionPercentage": 40,
    "cardPresentPercentage": 60,
    "cardNotPresentPercentage": 40
  },
  "owners": [
    {
      "title": "CEO",
      "firstName": "John",
      "lastName": "Doe",
      "percentage": 100,
      "ssn": "666989898",
      "dob": "1990-05-05T00:00:00.000Z",
      "address": {
        "street1": "500 S Main Street",
        "city": "Spokane",
        "state": "WA",
        "zipCode": "99206"
      },
      "phone": "+12234567890",
      "email": "[email protected]",
      "isControllingProng": true,
      "isPrimaryContact": true,
      "isPciContact": true
    }
  ],
  "bankAccount": {
    "name": "Chase",
    "routingNumber": "111000614",
    "confirmRoutingNumber": "111000614",
    "accountNumber": "987654321",
    "confirmAccountNumber": "987654321"
  }
}

📘

When you specfic one of the owners as the control prong, pci contact or primary Contact, you do not have to provide the properties of controlProng, pciContact or primaryContact.

{
 "legal": {
   // ... Other Properties
   "ownershipType": "LIMITED"
 },
 "owners": [
   {
     "title": "CEO",
     "firstName": "John",
     "lastName": "Doe",
     "percentage": 100,
     "ssn": "666989898",
     // Set as true to make controlProng null
     "isControllingProng": true, 
     // Set as true to make isPrimaryContact null
     "isPrimaryContact": true,
     // Set as true to make isPciContact null
     "isPciContact": true
   }
  ],
 "bankAccount": { /** Properties */ },
 // set as null since its not needed
 "controlProng": null, 
 // set as null since its not needed
 "primaryContact": null,
 // set as null since its not needed
 "pciContact": null
}

Ownership Type Requirements

`legal.ownershipType`

The ownershipType tells us how the business is structured. Read the ownershipTypes below to understand what fields are required for each type of business.

`LIMITED`

This is a limited liability company (LLC). When ownershipType is LIMITED, there should be owners and a control prong.

{
    "legal": {
      "ownershipType": "LIMITED",
    },
    "bankAccount": { /** Properties */ },
    "owners": [ {} ], // REQUIRED
    "controlProng": {} // REQUIRED
}

`CORPORATION`

This is a legally incorporated entity separate from its owners. When ownershipType is CORPORATION, there should be owners and a control prong.

{
    "legal": {
      "ownershipType": "CORPORATION",
    },
    "bankAccount": { /** Properties */ },
    "owners": [ {} ], // REQUIRED
    "controlProng": {} // REQUIRED
}

`GOVERNMENT`

This is a government entity or agency. When ownershipType is GOVERNMENT, no owners or control prong should be provided. You must also specify the primary contact and PCI contact.

{
    "legal": {
      "ownershipType": "GOVERNMENT",
    },
    "bankAccount": { /** Properties */ },
    "owners": null, // Set as null
    "controlProng": null, // Set as null
    "primaryContact": {}, // REQUIRED
    "pciContact": {} // REQUIRED
}

`SOLE PROPRIETOR`

This is a business owned and operated by a single individual. When ownershipType is SOLE PROPRIETOR, there should be only 1 owner and no control prong.

The legal.name field is required and should be the same as the owner's name.

{
  "legal": {
    // The name should match owners
    // owners first and last
    "name": "John Doe", // REQUIRED
    "ownershipType": "SOLE PROPRIETOR",
  },
  "bankAccount": { /** Properties */ },
  // REQUIRED Only 1 owner should exist
  "owners": [{ 
    "firstName": "John", 
    "lastName": "Doe" 
  }],
  "controlProng": null // Set as null
}

`PUBLIC COMPANY`

This is a corporation that offers securities for public trading. When ownershipType is PUBLIC COMPANY, no owners or control prong should be provided. You must also specify the primary contact and PCI contact.

{
    "legal": {
      "ownershipType": "PUBLIC COMPANY",
    },
    "bankAccount": { /** Properties */ },
    "owners": null, // Set as null
    "controlProng": null, // Set as null
    "primaryContact": {}, // REQUIRED
    "pciContact": {} // REQUIRED
}

`NON PROFIT ORG`

This is a non-profit organization with tax-exempt status. When ownershipType is NON PROFIT ORG, there should be no owners. There should be a control prong. You must also specify the primary contact and PCI contact.

{
    "legal": {
      "ownershipType": "NON PROFIT ORG",
    },
    "bankAccount": { /** Properties */ },
    "owners": null, // Set as null
    "controlProng": {}, // REQUIRED
    "primaryContact": {}, // REQUIRED
    "pciContact": {} // REQUIRED
}

`JOINT STOCK`

This is a joint-stock company with shared capital ownership. When ownershipType is JOINT STOCK, there should be owners and a control prong.

{
    "legal": {
      "ownershipType": "JOINT STOCK",
    },
    "bankAccount": { /** Properties */ },
    "owners": [ {} ], // REQUIRED
    "controlProng": {} // REQUIRED
}

`PARTNERSHIP`

This is a business owned by two or more partners. When ownershipType is PARTNERSHIP, there should be owners and a control prong.

{
    "legal": {
      "ownershipType": "PARTNERSHIP",
    },
    "bankAccount": { /** Properties */ },
    "owners": [ {} ], // REQUIRED
    "controlProng": {} // REQUIRED
}

`legal.mailingAddress`

📘
When legal.mailingAddressSameAsBusinessAddress is set to true, the legal.mailingAddress properties are not required.
{
 "legal": {
   // ... Other Properties
   "mailingAddressSameAsBusinessAddress": true, // REQUIRED
   "mailingAddress": null // Set as null when true above
 }
}}

`legal.b2bTransactionPercentage` `legal.b2cTransactionPercentage`

📘
The transaction percentage values reflect your target customer distribution. For example, if you exclusively sell to other businesses (B2B), set your b2bTransactionPercentage to 100. Conversely, if you only sell to consumers (B2C), set b2cTransactionPercentage to 100. You do not have to provide the properties of controlProng when one of the owners properties is isControllingProng: true. If you are selling to both B2B and B2C, you only need to provide one of the properties and it will automatically calculate the other.
{
 "legal": {
   // ... Other Properties
   // 'b2bTransactionPercentage' Will auto calculate to 60
   "b2bTransactionPercentage": null, // REQUIRED
   "b2cTransactionPercentage": 40
 }
}}

New Merchant Object

Ownership Type Requirements

legal.ownershipType

LIMITED

CORPORATION

GOVERNMENT

SOLE PROPRIETOR

PUBLIC COMPANY

NON PROFIT ORG

JOINT STOCK

PARTNERSHIP

legal.mailingAddress

legal.b2bTransactionPercentage legal.b2cTransactionPercentage