Update an existing membership profile including billing details, recurring settings, payment information, and customer account data.

Membership Administration - Update Member Info

Overview

The Update Member Info operation updates an existing membership profile with new or modified information. Only fields included in the request will be updated; all other existing values remain unchanged.

Request Parameters

Account Credentials

Variable Requirement Type Max Size Possible Values / Example Description
publisher-name Mandatory string N/A — Gateway account username issued to you.
publisher-password Mandatory string N/A — Remote Client Password. This is different than the password used to log in to the gateway.
mode Mandatory string N/A update_member Value must be set to update_member.

Membership Information

Variable Requirement Type Max Size Possible Values / Example Description
username Mandatory string 12 — Profile username used to identify the member.
password Optional string 12 — Profile password.
status Optional string 10 active, cancelled, pending, active Membership status. Valid values: active, cancelled, pending. If not provided, active is assumed.
plan Optional string 5 — Membership Plan ID.
purchaseid Optional string 20 — Used for custom grouping or reference identifiers.

Billing Schedule

Variable Requirement Type Max Size Possible Values / Example Description
startdate Optional string 8 YYYYMMDD Membership start/creation date.
Format: YYYYMMDD
enddate Optional string 8 YYYYMMDD Next scheduled billing date.
Format: YYYYMMDD
recfee Optional decimal 10 1234.56 Recurring billing amount. 1
currency Optional string 3 USD, EUR, CAD ISO 3-character currency code used with recfee (for example USD, EUR, CAD). Defaults to the account default currency when omitted.
balance Optional decimal 10 1234.56 Total amount to be billed (installment billing only).
Format: 00.00 1
billcycle Optional integer 2 — Recurring billing cycle in months. Set to 0 for non-recurring profiles.

Payment Information

Variable Requirement Type Max Size Possible Values / Example Description
card-name Optional string 39 — Name as it appears on the payment method.
card-address1 Optional string 39 — Billing Address Line 1.
card-address2 Optional string 39 — Billing Address Line 2.
card-city Optional string 39 — Billing city.
card-zip Optional string 10 — Billing ZIP code.
card-country Optional string 3 — Billing country code.
card-number Optional string 16 4111111111111111 Credit card number (numeric only).
Format: 4111111111111111
See Credit Card Storage Validation Policy.
card-exp Optional string 5 MM/YY Credit card expiration date.
Format: MM/YY

ACH / eCheck Information

Variable Requirement Type Max Size Possible Values / Example Description
routingnum Optional string 9 — ABA bank routing number. Required for ACH transactions.
accountnum Optional string 20 — Bank account number. Required for ACH transactions.

Contact Information

Variable Requirement Type Max Size Possible Values / Example Description
publisher-email Optional string 39 — Email address used for order confirmations and return email routing.
email Optional string 39 — Customer email address.

Shipping Information

Variable Requirement Type Max Size Possible Values / Example Description
shipname Optional string 39 — Shipping recipient name.
address1 Optional string 39 — Shipping Address Line 1.
address2 Optional string 39 — Shipping Address Line 2.
city Optional string 39 — Shipping city.
state Optional string 2 — Shipping state.
zip Optional string 10 — Shipping ZIP code.
country Optional string 3 — Shipping country.

Response Parameters

The following response values are returned after the membership profile update request has been processed.

Variable Value Description
FinalStatus success, problem success indicates the profile was updated successfully.
problem indicates the update failed.
auth-msg string Additional response message.
MErrMsg string Error message when applicable.
resp-code string Alphanumeric response code.

Notes

Partial Updates

⚠️ Only include fields you intend to update. Fields omitted from the request will remain unchanged.

If a field is submitted with an empty value, the system may clear the existing stored value.

⚠️ Formatting Rule (Applies to All Amount Fields)

  1. All monetary values must be numeric only in the format 1234.56. Do not include currency symbols, commas, or formatting. Exactly two decimal places are required. ↩︎ ↩︎