Syntch Gateway API

GetCustomer

Administration - Customer Management

**Requires Authentication**
Requires any of the roles:	Reseller, Merchant

The following routes are available for this service:
GET	/customers/{customerKey}	Get customer info

**GetCustomer** Parameters:
Name	Parameter	Data Type	Required	Description
CustomerKey	path	integer	Yes	Unique identifier assigned to the customer record by the system at the time the customer record is created.

**CustomerDetail** Parameters:
Name	Parameter	Data Type	Required	Description
CustomerKey	model	int	No	Unique identifier generated by the system for the customer
CustomerID	model	string	Yes	Unique identifier, assigned by the merchant, as a friendly way to identify the customer
CustomerName	model	string	No	Customer's full name. Can be first+last name for an individual, or the business name if applicable.
ActivationStatus	model	ActivationStatus?	Yes	Indicates whether the customer is currently active or inactive. Valid values are: 1: ACTIVE – Customers contracts are reviewed each day for pending payments 2: INACTIVE – Customer is not reviewed for pending payments
MerchantKey	model	int?	Yes	The merchant key for the customer
CreationTimestamp	form	DateTime	No	Customer creation timestamp.
LastUpdateTimestamp	form	DateTime	No	Last customer update timestamp.
DefaultContact	model	Contact	No	The link to this customer's default contact
BillingAddress	model	BillingAddress	No	The link to this customer's billing address
ShippingAddress	model	ShippingAddress	No	The link to this customer's shipping address

**ActivationStatus** Enum:
Pending
Active
Inactive
Deleted

**Contact** Parameters:
Name	Parameter	Data Type	Required	Description
LastName	model	string	No	The last name, max 50 chars
FirstName	model	string	No	The first name, max 50 chars
JobTitle	model	string	No	The job title, max 50 chars
DepartmentName	model	string	No	The department name, max 50 chars
EmailAddress	model	string	No	The e-mail address, max 100 chars
DaytimeTelephoneNumber	model	string	No	The daytime telephone number, max 25 chars
NighttimeTelephoneNumber	model	string	No	The nighttime telephone number, max 25 chars
FaxNumber	model	string	No	The fax number, max 25 chars
MobileTelephoneNumber	model	string	No	The mobile telephone number, max 25 chars
BillingAddress	model	Address	No	Billing address for the primary contact.
ShippingAddress	model	Address	No	Shipping address for the primary contact

**Address** Parameters:
Name	Parameter	Data Type	Required	Description
StreetAddress1	model	string	Yes	The street address, max 50 chars
StreetAddress2	model	string	No	The street address 2, max 50 chars
StreetAddress3	model	string	No	The street address 3, max 50 chars
City	model	string	No	The city, max 50 chars
StateOrProvinceCode	model	string	Yes	The CHAR-2 USA state and CAN province codes Allowable Values AK AL AR AZ CA CO CT DC DE FL GA HI IA ID IL IN KS KY LA MA MD ME MI MN MO MS MT NC ND NE NH NJ NM NV NY OH OK OR PA RI SC SD TN TX UT VA VT WA WI WV WY AB BC MB NB NL NS NT NU ON PE QC SK YT
PostalCode	model	string	Yes	The postal code, max 30 chars
CountryCode	model	string	Yes	The ISO Alpha-3 USA or CAN country codes Allowable Values USA CAN

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.

GET /customers/{customerKey} HTTP/1.1 
Host: syntch.simpay.net 
Accept: text/jsv

HTTP/1.1 200 OK
Content-Type: text/jsv
Content-Length: length

{
	CustomerKey: 0,
	CustomerID: String,
	CustomerName: String,
	ActivationStatus: Pending,
	MerchantKey: 0,
	CreationTimestamp: 0001-01-01,
	LastUpdateTimestamp: 0001-01-01,
	DefaultContact: 
	{
		LastName: String,
		FirstName: String,
		JobTitle: String,
		DepartmentName: String,
		EmailAddress: String,
		DaytimeTelephoneNumber: String,
		NighttimeTelephoneNumber: String,
		FaxNumber: String,
		MobileTelephoneNumber: String,
		BillingAddress: 
		{
			StreetAddress1: String,
			StreetAddress2: String,
			StreetAddress3: String,
			City: String,
			StateOrProvinceCode: String,
			PostalCode: String,
			CountryCode: String
		},
		ShippingAddress: 
		{
			StreetAddress1: String,
			StreetAddress2: String,
			StreetAddress3: String,
			City: String,
			StateOrProvinceCode: String,
			PostalCode: String,
			CountryCode: String
		}
	},
	BillingAddress: 
	{
		StreetAddress1: String,
		StreetAddress2: String,
		StreetAddress3: String,
		City: String,
		StateOrProvinceCode: String,
		PostalCode: String,
		CountryCode: String
	},
	ShippingAddress: 
	{
		StreetAddress1: String,
		StreetAddress2: String,
		StreetAddress3: String,
		City: String,
		StateOrProvinceCode: String,
		PostalCode: String,
		CountryCode: String
	}
}

Syntch Gateway API

GetCustomer

Allowable Values

Allowable Values

HTTP + JSV