Syntch Gateway API

<back to all web services

PostMerchantUser

Administration - Merchant Management
Requires Authentication
Required role:Merchant
The following routes are available for this service:
POST/merchants/usersCreates a new gateway user for the specified merchant.
PostMerchantUser Parameters:
NameParameterData TypeRequiredDescription
MerchantKeymodelintYes
GatewayUsermodelPostUserRequestYes
IsApiUsermodelboolYes
PostUserRequest Parameters:
NameParameterData TypeRequiredDescription
UserNameformstringNo
FirstNameformstringNo
LastNameformstringNo
EmailAddressformstringNo
PhoneNumberformstringNo
PasswordformstringNo
IsActiveformboolNo
IsLockoutEnabledformboolNo
IsTwoFactorEnabledformboolNo
Address1formstringNo
Address2formstringNo
CityformstringNo
StateformstringNo
ZipformstringNo
CountryformstringNo
ShouldChangePasswordOnNextLoginformboolNo
GatewayUser Parameters:
NameParameterData TypeRequiredDescription
UserNameformstringNo
PhoneNumberformstringNo
IdformintNo
DeleterUserIdformlong?No
CreatorUserIdformlongNo
LastModifierUserIdformlong?No
IsLockoutEnabledformboolNo
RolesformICollection<GatewayUserRole<Int64>>No
ClaimsformICollection<UserClaim>No
LoginsformICollection<GatewayUserLogin<Int64>>No
IsPhoneNumberConfirmedformboolNo
SecurityStampformstringNo
IsTwoFactorEnabledformboolNo
IsDeletedformboolNo
IsEmailConfirmedformboolNo
AccessFailedCountformintNo
LockoutEndDateUtcformDateTime?No
CreationTimeformDateTimeNo
LastModificationTimeformDateTime?No
DeletionTimeformDateTime?No
FirstNameformstringNo
EmailConfirmationCodeformstringNo
PasswordformstringNo
LastNameformstringNo
IsActiveformboolNo
EmailAddressformstringNo
TenantIdformint?No
AuthenticationSourceformstringNo
PasswordResetCodeformstringNo
LastLoginTimeformDateTime?No
Address1formstringNo
Address2formstringNo
CityformstringNo
StateformstringNo
ZipformstringNo
CountryformstringNo
TimezoneformstringNo
ShouldChangePasswordOnNextLoginformboolNo
UserClaim Parameters:
NameParameterData TypeRequiredDescription
ClaimTypeformstringNo
ClaimValueformstringNo
CreatorIdformintNo
TenantIdformintNo
CreateTimeformDateTimeNo

To override the Content-type in your clients, use the HTTP Accept Header, append the .jsv suffix or ?format=jsv

HTTP + JSV

The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.

POST /merchants/users HTTP/1.1 
Host: syntch.simpay.net 
Accept: text/jsv
Content-Type: text/jsv
Content-Length: length

{
	MerchantKey: 0,
	GatewayUser: 
	{
		UserName: String,
		FirstName: String,
		LastName: String,
		EmailAddress: String,
		PhoneNumber: String,
		Password: String,
		IsActive: False,
		IsLockoutEnabled: False,
		IsTwoFactorEnabled: False,
		Address1: String,
		Address2: String,
		City: String,
		State: String,
		Zip: String,
		Country: String,
		ShouldChangePasswordOnNextLogin: False
	},
	IsApiUser: False
}
HTTP/1.1 200 OK
Content-Type: text/jsv
Content-Length: length

{
	UserName: String,
	PhoneNumber: String,
	Id: 0,
	DeleterUserId: 0,
	CreatorUserId: 0,
	LastModifierUserId: 0,
	IsLockoutEnabled: False,
	Roles: [],
	Logins: [],
	IsPhoneNumberConfirmed: False,
	SecurityStamp: String,
	IsTwoFactorEnabled: False,
	IsDeleted: False,
	IsEmailConfirmed: False,
	AccessFailedCount: 0,
	LockoutEndDateUtc: 0001-01-01,
	CreationTime: 0001-01-01,
	LastModificationTime: 0001-01-01,
	DeletionTime: 0001-01-01,
	FirstName: String,
	EmailConfirmationCode: String,
	Password: String,
	LastName: String,
	IsActive: False,
	EmailAddress: String,
	TenantId: 0,
	AuthenticationSource: String,
	PasswordResetCode: String,
	LastLoginTime: 0001-01-01,
	Address1: String,
	Address2: String,
	City: String,
	State: String,
	Zip: String,
	Country: String,
	Timezone: String,
	ShouldChangePasswordOnNextLogin: False
}