This is an old revision of the document!
Describes a customer payment method.
This object describes a customer payment method. A payment method can be a CreditCard, ACH (Electronic Check), StoredValue (gift certificate, store credit, auto-reloading prepaid card, etc), and Invoice. The payment type is specified by setting MethodType to 'CreditCard', 'ACH', 'StoredValue' or 'Invoice'. If MethodType is left blank and credit card information is provided, the type will default to 'CreditCard'. If MethodType is left blank and electronic check information is provided, the type will default to 'ACH'.
The StoredValue method can be as simple as a store credit or as complex as linking to a physical pre-paid card or gift card with a magnetic strip. For a store credit or simple balance on account, the only required field is Balance. To use the StoredValue payment method, the merchant account must have stored value transactions enabled.
The Invoice method allows a merchant to collect transactions that will be invoice at a later date. Balance is increased by the system when an Invoice transaction is received. MaxBalance specifies that maximum balance that a customer can incur before Invoice transactions are declined. Setting MaxBalance to 0 will cause the customer to have no limit. To process Invoice transactions, the merchant account must have Invoice processing enabled.
|string||MethodType||Type of payment method ('CreditCard', 'ACH', 'StoredValue' or 'Invoice')|
|integer||MethodID||ID of payment method. This property is ignored when adding a new payment method but required if updating an existing method. (Read Only)|
|string||MethodName||Label for payment method. For example “Work Visa” or “Personal Checking.”|
|integer||SecondarySort||If set to value greater than 0, use this method as backup in case default fails. Secondary methods will be run in ascending order.|
|string||CardNumber||Credit card number (required for credit cards)|
|string||CardExpiration||Credit card expiration date in YYYY-MM format. It will also accept MMYY format. (required for credit cards)|
|string||AvsStreet||Street address for AVS (address verification system). (Optional but recommended for credit cards)|
|string||AvsZip||Zip code for AVS. (Optional but recommended for credit cards)|
|string||CardCode||CVV2/CID card identification code. This code is not stored and is only used when verifying a new payment method before it is added. (Optional for credit cards)|
|string||CardType||Type of credit card (Visa, Mastercard, etc). This is a read only parameter and will be ignored if set.|
|Electronic Check (ACH)|
|string||Account||ACH Bank Account Number (required for checks)|
|string||AccountType||ACH Type of Bank Account (Checking or Savings, defaults to checking)|
|string||Routing||ACH Bank Routing Number (required for checks)|
|string||DriversLicense||Drivers license number used for check guarantee (optional)|
|string||DriversLicenseState||Drivers license state (optional)|
|string||RecordType||ACH transaction type (optional, should be left blank unless instructed differently by check processor)|
|double||Balance||The amount that will be invoiced|
|double||MaxBalance||The maximum balance that may be charged on Invoice before transactions are declined|
|double||Balance||The funds left on the account. Transactions against this payment method may not exceed this balance|
|boolean||AutoReload||Set true if StoredValue card should automatically be reloaded|
|string||ReloadSchedule||Automatic reload schedule|
|double||ReloadThreshold||Balance that will trigger an automatic reload|
|double||ReloadAmount||Amount to automatically reload|
|integer||ReloadMethodID||Payment method to use for reloading card|
|AvsStreet||490 Maple Ave|
Dim payMethod As usaepay.PaymentMethod = New usaepay.PaymentMethod payMethod.CardExpiration = "1212" payMethod.CardNumber = "4000100011112224" payMethod.AvsStreet = "123 Main st." payMethod.AvsZip = "90046" payMethod.MethodName = "My Visa"
usaepay.PaymentMethod payMethod = new usaepay.PaymentMethod(); payMethod.CardExpiration = "1212"; payMethod.CardNumber = "4000100011112224"; payMethod.AvsStreet = "123 Main st."; payMethod.AvsZip = "90046"; payMethod.MethodName = "My Visa";
|1.4||Add MethodType, Balance, MaxBalance, AutoReload, ReloadSchedule, ReloadThreshold, ReloadAmount, ReloadMethodID|
|1.3||Dropped CreditCardData and CheckData. Added Account, AccountType, DriversLicense, DriversLicenseState, RecordType, Routing, AvsStreet, AvsZip, CardCode, CardExpiration, CardNumber and CardType|
|1.2||Added the Created and Modified Parameters|
|1.1||Soap 1.1 Release|