Billhighway Cloud API

<back to all web services

SubscriptionCreateRq

The following routes are available for this service:
POST/signup/api/nat/{natID}/group/{groupID}/subscription
POST/signup/api/nat/{natID}/group/{groupID}/{userType}/user/{userID}/subscription
SubscriptionCreateRq Parameters:
NameParameterData TypeRequiredDescription
NatIDpathintNo
GroupIDpathintNo
ClientGroupIDbodystringNo
UserTypepathstringNo
UserIDpathstringNo
FormDatabodySubscriberFormDataNo
SubscriptionInfobodySubscriptionInformationNo
VerificationInfobodyClientVerificationNo
CcPaymentInfobodyCcPaymentInformationNo
AchPaymentInfobodyAchPaymentInformationNo
BillMeLaterbodyBillMeLaterInformationNo
CampaignsbodyList<CampaignInformation>No
SubscriberFormData Parameters:
NameParameterData TypeRequiredDescription
FormTemplateIDformintNo
SignupTypeIDformintNo
FormFieldsformList<SubscriberFormField>No
SubscriberFormField Parameters:
NameParameterData TypeRequiredDescription
NameformstringNo
ValueformstringNo
SubscriptionInformation Parameters:
NameParameterData TypeRequiredDescription
FrequencyIDformintNo
SubscriptionInvoiceIDformintNo
AutoRenewformboolNo
HasAgreedToTermsformboolNo
ClientSubscriberIdformstringNo
RenewedMemberSubscriptionInvIDformintNo
ClientVerification Parameters:
NameParameterData TypeRequiredDescription
ProviderformstringNo
VerificationCodeformstringNo
CcPaymentInformation Parameters:
NameParameterData TypeRequiredDescription
CardNumberformstringNo
CvvformstringNo
ExpMonthformintNo
ExpYearformintNo
CardholderNameformstringNo
CountryformstringNo
BillingAddressformstringNo
Address1formstringNo
Address2formstringNo
CityformstringNo
StateProvinceformstringNo
PostalCodeformstringNo
AchPaymentInformation Parameters:
NameParameterData TypeRequiredDescription
AccountHolderNameformstringNo
CheckNumberformstringNo
RoutingNumberformstringNo
AccountNumberformstringNo
AccountTypeformstringNo
BillMeLaterInformation Parameters:
NameParameterData TypeRequiredDescription
IsBillMeLaterPaymentformboolNo
IsBillMeLaterSubscriptionformboolNo
MemberSubscriptionInvIdformintNo
CampaignsformList<CampaignInformation>No
CampaignInformation Parameters:
NameParameterData TypeRequiredDescription
CampaignIdformintNo
CampaignNameformstringNo
AmountformdecimalNo
ChapPayIDformstringNo
SubscriptionCreateRs Parameters:
NameParameterData TypeRequiredDescription
IsSuccessformboolNo
UniqueIdformstringNo
CreatedDateTimeformDateTimeNo
ClientIdformintNo
BillhighwayUserIdformintNo
ConfirmationNumberformstringNo
PaymentConfirmationNumberformlongNo
SubscriptionConfirmationNumberformlongNo
ErrorCodeformstringNo
MessageformstringNo
FriendlyMessageformstringNo

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.

POST /signup/api/nat/{natID}/group/{groupID}/subscription HTTP/1.1 
Host: devapi.billhighway.com 
Accept: application/json
Content-Type: application/json
Content-Length: length

{"NatID":0,"GroupID":0,"ClientGroupID":"String","UserType":"String","UserID":"String","FormData":{"FormTemplateID":0,"SignupTypeID":0,"FormFields":[{"FormTemplateFieldID":0,"Name":"String","Value":"String"}]},"SubscriptionInfo":{"FrequencyID":0,"SubscriptionInvoiceID":0,"AutoRenew":false,"HasAgreedToTerms":false,"ClientSubscriberId":"String","RenewedMemberSubscriptionInvID":0},"VerificationInfo":{"Provider":"String","VerificationCode":"String"},"CcPaymentInfo":{"CardNumber":"String","Cvv":"String","ExpMonth":0,"ExpYear":0,"CardholderName":"String","Country":"String","BillingAddress":"String","Address1":"String","Address2":"String","City":"String","StateProvince":"String","PostalCode":"String"},"AchPaymentInfo":{"AccountHolderName":"String","CheckNumber":"String","RoutingNumber":"String","AccountNumber":"String","AccountType":"String"},"BillMeLater":{"IsBillMeLaterPayment":false,"IsBillMeLaterSubscription":false,"MemberSubscriptionInvId":0,"Campaigns":[{"CampaignId":0,"CampaignName":"String","Amount":0,"ChapPayID":"String"}]},"Campaigns":[{"CampaignId":0,"CampaignName":"String","Amount":0,"ChapPayID":"String"}]}
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: length

{"IsSuccess":false,"UniqueId":"String","CreatedDateTime":"0001-01-01T00:00:00.0000000","ClientId":0,"BillhighwayUserId":0,"ConfirmationNumber":"String","PaymentConfirmationNumber":0,"SubscriptionConfirmationNumber":0,"ErrorCode":"String","Message":"String","FriendlyMessage":"String"}