Syntch Gateway API

<back to all web services

GetCustomerContracts

Administration - Recurring Billing Contracts
Requires Authentication
Requires the role:Merchant
The following routes are available for this service:
GET/merchants/{merchantKey}/customers/{customerKey}/contractsGet all contract details for a customer.
GetCustomerContracts Parameters:
NameParameterData TypeRequiredDescription
MerchantKeypathintegerYesThe key of the merchant.
CustomerKeypathintegerYesThe customer key.
ContractDetail Parameters:
NameParameterData TypeRequiredDescription
ContractKeyformintNo
MerchantKeyformintNo
CustomerKeyformintNo
TokenformstringNo
BillAmountformdecimalNo
StartDateformDateTime?No
EndDateformDateTime?No
MerchantContractNameformstringNo
MerchantContractIdformstringNo
BillingIntervalformint?No
BillingPeriodformstringNo
ActivationStatusformstringNo
MaxFailuresformint?No
FailureIntervalformint?No
FailurePeriodformstringNo
EmailMerchantformboolNo
EmailCustomerformboolNo
EmailMerchantFailureformboolNo
EmailCustomerFailureformboolNo
TaxAmountformdecimalNo
TotalAmountformdecimalNo
MaxAmountformdecimal?No
CustomFieldsformList<ContractCustomField>No
AmountBillsToDateformdecimalNo
EmailCustomerReceiptOptionformstringNo
NextBillDateformDateTime?No
NumberPaymentsformint?No
NumberBillsToDateformint?No
NumberFailuresformint?No
ContractCustomField Parameters:
NameParameterData TypeRequiredDescription
CustomValueformstringNo
CustomKeyformintNo

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

To embed the response in a jsonp callback, append ?callback=myCallback

HTTP + JSON

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

GET /merchants/{merchantKey}/customers/{customerKey}/contracts HTTP/1.1 
Host: syntch.simpay.net 
Accept: application/json
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: length

{"ContractKey":0,"MerchantKey":0,"CustomerKey":0,"Token":"String","BillAmount":0,"StartDate":"0001-01-01T00:00:00.0000000","EndDate":"0001-01-01T00:00:00.0000000","MerchantContractName":"String","MerchantContractId":"String","BillingInterval":0,"BillingPeriod":"String","ActivationStatus":"String","MaxFailures":0,"FailureInterval":0,"FailurePeriod":"String","EmailMerchant":false,"EmailCustomer":false,"EmailMerchantFailure":false,"EmailCustomerFailure":false,"TaxAmount":0,"TotalAmount":0,"MaxAmount":0,"CustomFields":[{"CustomValue":"String","CustomKey":0}],"AmountBillsToDate":0,"EmailCustomerReceiptOption":"String","NextBillDate":"0001-01-01T00:00:00.0000000","NumberPayments":0,"NumberBillsToDate":0,"NumberFailures":0}