You are here: SOAP Services > Billing > updatepayment

updatepayment

Summary

The updatepayment operation allows you to update the stored billing method for a member's account.

Service Type SOAP
Service Name Billing
Operation updatepayment
Required Request Parameters
  • club
  • agreementNumber
  • accountFirstName
  • accountLastName
  • billingInfo

and either

  • creditCardType
  • creditCardAccountNumber
  • creditCardExpMonth
  • creditCardExpYear

or

  • routingNumber
  • accountNumber
  • accountType

The required parameter billingInfo must contain either creditCard or bankAccount.
If billingInfo = creditCard, the five additional credit card parameters are required.
If billingInfo = bankAccount, the four additional bank account parameters are required.

Request Parameters

The request has the following parameters:

Parameter Name Required? Format Parent Parameter Description
club Y club number The number for the club.
agreementNumber Y agreement number The agreement number for the membership agreement.
accountFirstName Y string

The first name associated with an account used with ongoing payments.

If a request is made using an accountFirstName and/or accountLastName that is different from the account holder's name, the submitted will appear on ABC's billing system as "Draft Under Name." No changes will be made to the account holder's personal information.

accountLastName Y string

The last name associated with an account used with ongoing payments.

If a request is made using an accountFirstName and/or accountLastName that is different from the account holder's name, the submitted will appear on ABC's billing system as "Draft Under Name." No changes will be made to the account holder's personal information.

billingInfo Y Contains the billing information for ongoing payments. Must contain one instance of either creditCard or bankAccount.
creditCard billingInfo

Contains the details of the credit card information used for ongoing payments.

Child parameters:

  • creditCardType
  • creditCardAccountNumber
  • creditCardExpMonth
  • creditCardExpYear
creditCardType Yes, if billingInfo = creditCard string creditCard

Valid values:

  • Visa
  • Discover
  • AmericanExpress
  • MasterCard
creditCardAccountNumber Yes, if billingInfo = creditCard string creditCard The credit card account number used to make the payment.
creditCardExpMonth

Yes, if billingInfo = creditCard

## creditCard The expiration month of the credit card.
creditCardExpYear

Yes, if billingInfo = creditCard

#### creditCard The expiration year of the credit card.
bankAccount

 

string billingInfo Contains the details of a member's bank account for the payment.
routingNumber

Yes, if billingInfo = bankAccount

string bankAccount The routing number associated with the member's bank account.
accountNumber

Yes, if billingInfo = bankAccount

string bankAccount The account number associated with the member's bank account.
accountType

Yes, if billingInfo = bankAccount

string bankAccount The account type of the bank account.

Return Data

The return data is included inside return parameters in the body of the response.

The data has the following parameter hierarchy:

Parameter Name Format Parent Parameter Description
club club number The number for the club.
agreementNumber agreement number The agreement number for the membership agreement.
status Contains the details of a status message.
status string status

Contains a status code.

Example:

  • Failed indicates a failed request.
  • Success indicates a successful request.
message string status Contains any additional details about the status.