Update Vault Records
Over the course of their existence, Vault Records may have certain aspects of their data changed. For example, if the customer moves and has their billing address linked to their card charged, you would just want to update that Vault Record within the system rather then adding a new one entirely.
Updating a BankAccount
| Field | Method on BankAccount Object | Description |
|---|---|---|
| Billing Address | setBillingAddress( Address vo_address ) | The billing address for the account holder. When this object is set on the BankAccount, the entire current Billing Address set on the BankAccount object will be overwritten with the new Billing Address. |
| Routing Number | setRoutingNumber( String vs_routing_number ) | The account holder's routing number. |
What You Cannot Send
| Field | Method on BankAccount Object |
|---|---|
| Account Number | setAccountNumber( String vs_account_number ) |
Address o_address = new Address( Address.XS_ADDRESS_NAME_BILLING );
o_address.setLine1( "1239 test lane" );
o_address.setZipcode( "12345" );
o_address.setCity( "Hometown" );
o_address.setState( "HI" );
o_address.setCountry( "US" );
BankAccount o_bank_account = new BankAccount();
o_bank_account.setRoutingNumber( "011001962" );
o_bank_account.setBillingAddress( o_address );
o_bank_account.setToken( "e604b169820e45b79bc87a357be848b7ebb25229a7c741386595d155209acc63" );
BaseCommerceClient o_client = new BaseCommerceClient( XS_USERNAME, XS_PASSWORD, XS_KEY );
o_bank_account = o_client.updateBankAccount( o_bank_account );
if ( o_bank_account.isStatus(BankAccount.XS_BA_STATUS_FAILED ) ) {
// Bank Account add failed, look at messages for reasons why
System.out.println( o_bank_account.getMessages() );
} else if ( o_bank_account.isStatus(BankAccount.XS_BA_STATUS_ACTIVE ) ) {
// BankAccount update Successful
}
Updating a BankCard
| Field | Method on BankCard Object | Description |
|---|---|---|
| Billing Address | setBillingAddress( Address vo_address ) | The cardholder's billing address. When this object is set on the BankCard, the entire current Billing Address set on the BankCard object will be overwritten with the new Billing Address. |
| Expiration Month | setExpirationMonth( String vs_expiration_month ) | The expiration month on the payment card of the consumer. |
| Expiration Year | setExpirationYear( String vs_expiration_year ) | The expiration year on the payment card of the consumer. |
What You Cannot Send
| Field | Method on BankCard Object |
|---|---|
| Card Number | setNumber( String vs_card_number ) |
Address o_address = new Address( Address.XS_ADDRESS_NAME_BILLING );
o_address.setLine1( "1239 test lane" );
o_address.setZipcode( "12345" );
o_address.setCity( "Hometown" );
o_address.setState( "HI" );
o_address.setCountry( "US" );
BankCard o_bank_card = new BankCard();
o_bank_card.setExpirationMonth( "09" );
o_bank_card.setExpirationYear( "2020" );
o_bank_card.setToken( "b920975a4bbb5712e0cf2f78b6f443c558aa68fc0a111814a8b4500d1f95c4a1" );
o_bank_card.setBillingAddress( o_address );
BaseCommerceClient o_client = new BaseCommerceClient( XS_USERNAME, XS_PASSWORD, XS_KEY );
o_bank_card = o_client.updateBankCard( o_bank_card );
if ( o_bank_card.isStatus( BankCard.XS_BC_STATUS_FAILED ) )
// Bank Card update failed, look at messages for reasons why
System.out.println("failed: " + o_bank_card.getMessages());
} else if (BankCard.XS_BC_STATUS_ACTIVE.equals(o_bank_card.getStatus())) {
// Bank Card Updated Successful
}