Skip to main content

Class RegisterAccountRequest


Properties

NAMETYPELENGTHREQUIREDDESCRIPTION
storeIdlongYUnique user ID generated by EPS. (See - Required Data Elements)
storeKeystringYUnique password generated by EPS. (See - Required Data Elements)
entityIdintYUnique identifier that is generated by EPS. (See - Required Data Elements)
WSAccountWSAccount

WSAccount

NAMETYPELENGTHREQUIREDDESCRIPTION
CustomerNumberstring50Unique identifier assigned to the registered customer associated with this account. (See - System Required/User Optional Data Elements)
AccountTypeenum of Type WSAccountTypeY*Valid values are:
  • Checking
  • Savings
  • Treasury_Check
  • Money_Order
  • Travelers_Check
  • Convenience_Check
  • Visa
  • MasterCard
  • Discover__Novus
  • American_Express
  • Diners__Carte_Blanche
  • enRoute
  • JCB
  • Bank_Card
  • Gift_Card
  • On_Us_Card
  • Payroll_Card
  • Cashiers_Check
  • Virtual Card
  • __None


*NOTE: Required for credit card transactions. If Null and the RoutingNumber element is supplied, the default value of “Checking” is used.
NameOnAccountstring50YCustomer’s name as it appears on the account.
AccountNamestring50Customer’s name or an account nickname. Can be empty but can’t be Null.
AccountNumberstring17Ychecking or savings accounts: 3-17 digits; credit card accounts: 16 digits or less
RoutingNumberint9Y**Required for checking and savings accounts only. Element should be removed if this is a credit card account.
ExpirationMonthbyte2Y**Required for credit card accounts only.

Valid values must be between 01 and 12. Element should be removed if this is a checking or savings account
ExpirationYearbyte2Y**Required for credit card accounts only. Valid values must not exceed 10 years out from the current year. (I.e. for year 2011, the value cannot be greater than 2021). Element should be removed if this is a checking or savings account.
BillAddress1string50Street address associated with this account, if different from the customer address.
BillAddress2string50Additional street address information associated with this account, if different from the customer address.
BillCitystring40City associated with this account, if different from the customer address.
BillStateRegionstring40State/Region associated with this account, if different from the customer address.
BillPostalCodestring10Zip/Postal Code associated with this account, if different from the customer address.
BillCountrystring40Country associated with this account, if different from the customer address.
ApprovedboolNo longer used. (See - Optional Data Elements)
UsedForMatchingboolNo longer used. (See - Optional Data Elements)
AccountReferenceIDstring50Unique identifier to be assigned to this account. (See - System Required/User Optional Data Elements)
bypassSmartDetectboolThis is an optional element which will bypass the SmartDetect Service.

Possible values are:
  • 0 = False; 1 = True and Null
  • Default to False


Note: This element cannot be empty or blank. If you are not using the SmartDetect service, you must provide a value of False or Null. If you are using the SmartDetect service but do not wish to bypass SmartDetect for a given request, you must also provide a value of False or Null.

Examples

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:pv="https://ssl.selectpayment.com/PV">
<soapenv:Header>
<pv:SecurityHeader>
<pv:BinarySecurityToken>your security token here</pv:BinarySecurityToken>
</pv:SecurityHeader>
</soapenv:Header>
<soapenv:Body>
<pv:RegisterAccount>
<pv:storeId>0</pv:storeId>
<pv:storeKey isNull="true" />
<pv:entityId>12345</pv:entityId>
<pv:account>
<pv:CustomerNumber>1245</pv:CustomerNumber>
<pv:AccountType>Checking </pv:AccountType>
<pv:NameOnAccount>Sam Shultz</pv:NameOnAccount>
<pv:AccountName>Sam’s Cigars</pv:AccountName>
<pv:AccountNumber>123445567</pv:AccountNumber>
<pv:RoutingNumber>111222233</pv:RoutingNumber>
<pv:BillAddress1>2 Smoking Place </pv:BillAddress1>
<pv:BillAddress2> </pv:BillAddress2>
<pv:BillCity>Dallas </pv:BillCity>
<pv:BillStateRegion>TX</pv:BillStateRegion>
<pv:BillPostalCode>12345</pv:BillPostalCode>
<pv:BillCountry>USA</pv:BillCountry>
<pv:AccountReferenceID>101</pv:AccountReferenceID>
<pv:bypassSmartDetect>False</pv:bypassSmartDetect>
</pv:account>
</pv:RegisterAccount>
</soapenv:Body>
</soapenv:Envelope>