Register Payor

post

https://mapi.pockyt.io/v1/payor/register

This endpoint is used to register a new Payor (sub-merchant) under a Merchant of Record (MoR) account. The response includes a payorNo used to refer to the registered Payor for future operations such as document uploads, payee registration, and payouts.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

merchantNo

string

required

Defaults to 202999

Merchant ID in Pockyt's system. A unique value created and assigned by Pockyt's support team during the onboarding process

storeNo

string

required

Defaults to 302468

Store Number in Pockyt's system. A unique value created and assigned by Pockyt's support team during the onboarding process

verifySign

string

required

Defaults to a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6

The parameter signature. It is the calculated MD5 hash value of the API token used to encrypt the request message and authorize transaction requests. For more information, visit Signing API Parameters

timestamp

string

required

Defaults to 2026-04-22T10:30:00Z

Current UTC time, correct format should be "yyyy-mm-ddTHH:MM:SSZ"

legalName

string

required

Defaults to Test Payor Company LLC

Legal company name of the Payor being registered

dbaName

string

required

Defaults to Test Payor DBA

Doing Business As (DBA) name of the Payor

country

string

required

Defaults to US

Country code in ISO 3166-1 alpha-2 format (e.g., "US")

state

string

required

Defaults to New York

State or province of the business

city

string

required

Defaults to New York

City of the business

address

string

required

Defaults to 123 Main Street

Street address of the business

zipCode

string

required

Defaults to 10001

Postal/ZIP code of the business

phone

string

required

Defaults to +12125551234

Contact phone number including country code (e.g., "+12125551234")

string

required

Defaults to [email protected]

Contact email address. Must be unique across all Payors

website

string

Defaults to https://www.testpayor.com

Company website URL (optional)

mcc

string

required

Defaults to 5734

Merchant Category Code for the business

taxId

string

required

Defaults to 12-3456789

Tax ID or EIN of the business

description

string

Defaults to Test Payor business

Brief description of the business (optional)

enterpriseType

integer

required

Defaults to 2

Business entity type. Accepted values: 1 = Individual, 2 = Corporation, 3 = Partnership, 4 = LLC

registrationNo

string

required

Defaults to REG123456

Business registration number

registrationDate

string

required

Defaults to 2020-01-15

Business registration date in "yyyy-MM-dd" format

registrationExpireDate

string

required

Defaults to 2030-01-14

Business registration expiration date in "yyyy-MM-dd" format, or "PERMANENT" if no expiration

dbaCountry

string

required

Defaults to US

DBA address country code in ISO 3166-1 alpha-2 format

dbaState

string

required

Defaults to NY

DBA address state or province

dbaCity

string

required

Defaults to New York

DBA address city

dbaAddress

string

required

Defaults to 456 DBA Street

DBA street address

dbaZipCode

string

required

Defaults to 10002

DBA postal/ZIP code

maxAdminNumber

integer

required

Defaults to 10

Maximum number of admin accounts allowed for this Payor

settlementCurrency

integer

required

Defaults to 1

Settlement currency. Accepted values: 1 = USD

timezoneArea

string

required

Defaults to America/New_York

Timezone area identifier (e.g., "America/New_York")

bankName

string

required

Defaults to Test Bank

Name of the Payor's bank

accountNumber

string

required

Defaults to 123456789012

Payor's bank account number

routingNumber

string

required

Defaults to 021000021

Bank routing number (US)

represFirstName

string

required

Defaults to John

First name of the authorized representative

represLastName

string

required

Defaults to Doe

Last name of the authorized representative

represTitle

string

Defaults to CEO

Job title of the authorized representative (optional)

represPhone

string

required

Defaults to +12125555678

Phone number of the authorized representative

represCountry

string

required

Defaults to US

Country code of the representative's address

represState

string

required

Defaults to NY

State or province of the representative's address

represStreetAddress

string

required

Defaults to 100 Representative Ave

Street address of the authorized representative

represCity

string

required

Defaults to New York

City of the representative's address

represZipCode

string

required

Defaults to 10004

Postal/ZIP code of the representative's address

represGovernmentIdType

string

required

Defaults to PASSPORT

Type of government-issued ID for the representative. Accepted values: PASSPORT, DRIVER_LICENSE, ID_CARD, SSN, RESIDENT_ALIEN_CARD, ELECTORAL_CARD, NATIONAL_ID, TAX_ID, OTHER

represGovernmentId

string

required

Defaults to P123456789

Government-issued ID number for the representative

represIssueCountry

string

required

Defaults to US

Country that issued the representative's government ID

represIssueDate

string

Defaults to 2015-06-20

Issue date of the representative's government ID in "yyyy-MM-dd" format (optional)

represExpireDate

string

Defaults to 2025-06-19

Expiration date of the representative's government ID in "yyyy-MM-dd" format (optional)

owners

string

Defaults to [{"firstName":"Jane","lastName":"Smith","title":"CFO","ownership":"30","dateOfBirth":"1985-03-20","phone":"+12125559876","email":"[email protected]","country":"US","citizenship":"US","state":"NY","city":"New York","address":"456 Oak Street","zipCode":"94103","governmentIdType":"SSN","governmentId":"123456789"}]

JSON-encoded array of owner/shareholder objects. Each object includes: firstName, lastName, title, ownership (percentage), dateOfBirth (yyyy-MM-dd), phone, email, country, citizenship, state, city, address, zipCode, governmentIdType, governmentId, and optionally issueExpireDate (optional)

annualRevenue

number

Annual revenue of the business (optional)

numberOfEmployee

integer

Number of employees at the business (optional)

sourceOfFunds

string

JSON-encoded array of source of funds values (optional)

payInCountries

string

JSON-encoded array of pay-in country codes (optional)

payInCurrencies

string

JSON-encoded array of pay-in currency codes (optional)

payOutCountries

string

JSON-encoded array of pay-out country codes (optional)

payOutCurrencies

string

JSON-encoded array of pay-out currency codes (optional)

purposeOfPayouts

string

JSON-encoded array of payout purpose values (optional)

Response

200200