Update Account

post

https://api-{corename}.{env}.gpsrv.com/intserv/4.0/updateAccount

Use the Update Account endpoint to modify customer profile information in an existing customer record. Pass only the parameters to modify — other parameters should be left blank. Only active accounts (status: N) can be updated using this endpoint, unless you set provider parameter UPDCZ to update accounts in status: C or status: Z.

Nullifying data elements

Pass the string null for any of these parameters to update that value to null.


`firstName`	`middleName`	`lastName`	`address1`
`city`	`state`	`postalCode`	`primaryPhone`
`otherPhone`	`mobilePhone`	`shipToAddress1`	`webUid`
`secretQuestion`	`secretAnswer`	`mailBounced`	`email`*
`embossLine2`

*Only if the provider parameter AENUL is set.

🚧
Warning
Exercise caution when nullifying a primary address — for compliance in the United States you must maintain a physical address as an individual cardholder's primary address.

Updating customer ID

When you are using Galileo's integrated CIP process, you can update the primary customer ID (id and idType) as long as the customer has not passed CIP. If the customer has already passed CIP, status code 415-02 is returned. Secondary and tertiary customer IDs (id2/idType2 and id3/idType3) can be updated regardless of customer CIP status.

Updating the ship-to address

When updating the ship-to address for a customer, the elements shipToAddress1, shipToCity, shipToState, and shipToPostalCode are required – shipToAddress2 is optional. You can retrieve the current customer ship-to address data using the Get Account Cards endpoint.

By default, the embosser sends the card to the primary address. To ship to a different address than the primary, use the ship-to address fields. If you pass shipToAddressPermanent: 1 the embosser will always send cards to the ship-to address; otherwise, the ship-to address is used only for the current order.

Status codes

See Global Response Statuses for status codes that are common across endpoints.

The table below lists status codes that apply to this specific endpoint.

Status code	Description
48	`Preferred Name not supported for this product.` Resend without `preferredName` or `displayPreferredNameOnlyOnCard` in the request.
415-01	Account information could not be updated at this time. Please try again later.
415-02	Customer primary ID can not be modified when CIP is passed
415-03	All elements except shipToAddress2 required for ship to address
415-04	Your provider configuration does not allow the nullifying of email address
415-05	Changing SSN is not allowed

Form Data

apiLogin

string

required

Web service username, as provided by Galileo.
Pattern: Max 50 characters
Example: "AbC123-9999"

apiTransKey

string

required

Web service password, as provided by Galileo.
Pattern: Max 15 characters
Example: "4sb62fh6w4h7w34g"

providerId

int32

required

Galileo-issued provider identifier.
Pattern: Max 10 digits
Example: 9999

transactionId

string

required

1 to 60

A unique provider-generated ID to identify this API call. A UUID is preferred.
Pattern: 60 characters or less
Example: "9845dk-39fdk3fj3-4483483478"

accountNo

string | null

The PRN or PAN of the account.
Pattern: PAN or PRN
Example: "074103447228"

idType

int32 | null

enum

Specifies the type of primary identifier in the id parameter. This parameter is required when id is populated. See the ID column in the Customer ID Types table for valid values.
Pattern: 1- or 2-digit integer
Example: 2

string | null

The value of the primary identifier that is specified in idType. Product settings determine whether thisPrimary ID for the account holder. This parameter is required when using Galileo's integrated CIP solution. Galileo converts all letters to lowercase.
Pattern: As specified in the Layout column of the Customer ID Types enumeration
Example: "123456789"

idType2

int32 | null

enum

Specifies the type of secondary identifier in the id2 parameter. This parameter is required when id2 is populated. See the ID column in the Customer ID Types table for valid values.
Pattern: 1- or 2-digit integer
Example: 1

id2

string | null

The value of the secondary identifier that is specified in idType2. Galileo converts all letters to lowercase.
Pattern: As specified in the Layout column of the Customer ID Types enumeration
Example: "123456789012|ut|12/25/2020"

idType3

int32 | null

enum

Specifies the type of tertiary identifier in the id3 parameter. This parameter is required when id3 is populated. See the ID column in the Customer ID Types table for valid values.
Pattern: 1- or 2-digit integer
Example: 1

id3

string | null

The value of the tertiary identifier that is specified in idType3. Galileo converts all letters to lowercase.
Pattern: As specified in the Layout column of the Customer ID Types enumeration
Example: "abc123456789|05-22-2027"

locationType

int32 | null

enum

Defaults to 0

Type of ID in location:

0 — Galileo location ID
1 — Partner location ID
2 — Don't validate
3 — Instant-issue location override. Valid for Create Account only. See Setup for Instant Issue for details.

Pattern: Integer
Example: 0

Allowed:

location

string | null

Unique location identifier (location) as returned by the Create Location endpoint. This value is also returned by the Get Locations endpoint depending on the value of locationType when the location was created:

0 or 2 — Returned in the location_id field
1 — Returned in the provider_specified_id field

Pattern: Integer if locationType: 0 or locationType: 2; max 15 characters if locationType: 1
Example: "a455-3483"

locale

string | null

enum

Defaults to en_US

The account holder language and localization preference. Valid values are en_US, es_US, fr_CA, en_CA, es_MX, en_MX. If the account holder address is outside the U.S., pass a non _US value for this parameter to disable U.S. address validation.
Pattern: Letters with underscore
Example: "en_US"

Allowed:

externalAccountId

string | null

≤ 30

Identifier supplied by the provider, which is not related to the Galileo system. This ID is stored in the Galileo system in association with this account and can be provided in the RDFs.
Pattern: Max 30 alphanumeric characters. Lowercase only.
Example: "553b45sbs"

firstName

string | null

1 to 40

Account holder's first name. Special character support.
Pattern: 1–40 characters: letters (A-Z, a-z), spaces, hyphens (-) and single quotes (')
Example: "Ed"

middleName

string | null

1 to 40

Account holder's middle name. Special character support.
Pattern: 1–40 characters: letters (A-Z, a-z), spaces, hyphens (-) and single quotes (')
Example: "W"

lastName

string | null

1 to 40

Account holder's last name. Special character support.
Pattern: 1–40 characters: letters (A-Z, a-z), spaces, hyphens (-) and single quotes (')
Example: "Harley"

dateOfBirth

date-time | null

Account holder's birth date. This date is compared with the DOB product parameter when there is a minimum age requirement on the account.
Pattern: YYYY-MM-DD
Example: "1980-01-01"

address1

string | null

Account holder's first address line. Cannot be a P.O. box. Validation rules for address1.
Pattern: 4–40 alphanumeric characters
Example: "33 Maple Street"

address2

string | null

Account holder's second address line.
Pattern: Max 40 alphanumeric characters and address symbols
Example: "#4B"

address3

string | null

Account holder's third address line.
Pattern: Max 30 alphanumeric characters and address symbols
Example: "Carrera Central"

address4

string | null

Account holder's fourth address line.
Pattern: Max 30 alphanumeric characters and address symbols
Example: "Barrio El Alhambra"

address5

string | null

Account holder's fifth address line.
Pattern: Max 30 alphanumeric characters and address symbols
Example: "Piso 3"

city

string | null

Account holder's city.
Pattern: Max 30 characters: letters, spaces, hyphen and period
Example: "Salt Lake City"

state

string | null

Account holder's state or province.
Pattern: String
Example: "UT"

postalCode

string | null

4 to 10

Account holder's postal code (ZIP code).
Pattern: 1234, 12345, 12345-1234, or K1A-1A1
Example: "84121"

countryCode

string | null

Account holder's country. Three-digit UN M49 code, such as 840 for USA, 124 for Canada, 484 for Mexico, 170 for Colombia.
Pattern: 3-digit number
Example: "840"

primaryPhone

string | null

Account holder's primary phone number. When passing a value for this parameter, you must also pass mobilePhoneCountryCode.
Pattern: Validation according to the value in mobilePhoneCountryCode.
Example: "8015556060"

otherPhone

string | null

Account holder's secondary phone number. When passing a value for this parameter, you must also pass mobilePhoneCountryCode.
Pattern: Validation according to the value in mobilePhoneCountryCode.
Example: "8015556060"

mobilePhone

string | null

Account holder's mobile phone number. When passing a value for this parameter, you must also pass mobilePhoneCountryCode.
Pattern: Validation according to the value in mobilePhoneCountryCode.
Example: "8015556060"

mobileCarrierId

string | null

Account holder's mobile carrier. Configurable list.
Pattern: Configurable list
Example: "8"

string | null

Account holder's email.
Pattern: Email address, 3–63 characters
Example: "[email protected]"

webUid

string | null

4 to 30

Account holder's username for the Galileo-hosted website. Must be unique across the program.
Pattern: Alphanumeric, with first character a letter; case insensitive
Example: "eharley"

webPwd

string | null

Account holder's password for the Galileo-hosted website.
Pattern: Min 8 characters: must include upper-case character, lower-case character, and a number
Example: "4j9KH3kkdh"

secretQuestion

string | null

≤ 50

Account holder's secret question for the Galileo-hosted website.
Pattern: Max 50 characters: letters, spaces, ?
Example: "What was the name of your first pet?"

secretAnswer

string | null

≤ 50

Account holder's answer to secretQuestion.
Pattern: Max 50 characters: letters, spaces, ?
Example: "Larry"

incomeSource

string | null

2 to 60

Account holder's employer name or income source.
Pattern: Max 60 characters: alphanumeric, space, underscore, hyphen, period, @, & and comma.
Example: "Kroger Food & Drug"

occupation

string | null

2 to 60

Account holder's occupation.
Pattern: Max 60 characters: alphanumeric, space, underscore, hyphen, period, @, & and comma.
Example: "Project Manager"

nationality

string | null

Account holder's nationality.
Pattern: 2-character ISO-3166-2 code
:Example: "MX"

placeOfBirth

string | null

Account holder's place of birth
Pattern: ISO-3166-2 subdivision code
Example: MX-YUC

curp

string | null

Account holder's CURP
Pattern: 18 alphanumeric characters
Example: "HRGRAL82050602H900"

politicalAffiliation

int32 | null

0 to 1

Whether the account holder is a PEP.

1 — PEP
0 — Not a PEP.

kycRefNo

string | null

KYC reference number to track the KYC process for the account holder.
Pattern: 36 characters
Example: "KYC123456789012312312312521312312312"

monthlyIncome

float | null

0 to 9999999999

Monthly income for the account holder.
Pattern: Float between 0 and 9999999999
Example: 3400.00

externalCustomerId

string | null

≤ 512

Identifier supplied by the provider, which is not related to the Galileo system.
Pattern: Max 512 characters: all ASCII characters
Example: "acv#-@45!sbsxm%-"

mailBounced

string | null

≤ 1

Y indicates that mail has been returned to sender.
Pattern: Y or N
Example: "Y"

shipToAddress1

string | null

First ship-to address line.
Pattern: Max 40 characters
Example: "33 business parkway"

shipToAddress2

string | null

≤ 40

Second ship-to address line.
Pattern: Max 40 characters
Example: "Suite 400"

shipToCity

string | null

Ship-to city.
Pattern: Max 30 characters
Example: "Salt Lake City"

shipToState

string | null

Ship-to state.
Pattern: String
Example: "UT"

shipToPostalCode

string | null

4 to 10

Ship-to ZIP or postal code.
Pattern: 1234, 12345, 12345-1234, K1A-1A1
Example: "841213333"

shipToCountryCode

string | null

Ship-to country. Three-digit UN M49 country code, such as 840 for USA, 124 for Canada, 484 for Mexico, 170 for Colombia.
Pattern: 3-digit number
Example: "840"

shipToAddressPermanent

string | null

Pass 1 to always ship cards to the ship-to address instead of one time only.
Pattern: 0 or 1
Example: "1"

embossLine2

string | null

≤ 28

Second line to emboss on the card.
Pattern: Supported characters
Example: "Scarlet Ibis Shipping"

businessName

string | null

Account holder's business name. This field is required if prodId is a business product.
Pattern: 2–150 characters. See the supported character set.
Example: "Ed%26Ted"

mobilePhoneCountryCode

string | null

2 to 4

Account holder's mobile phone country code.
Pattern: A plus sign followed by 1–3 digits. See Phone Validation for valid values.
Example: "+1"

Headers

response-content-type

string

enum

Defaults to json

Use this header instead of the standard accept header to specify the response format.

Allowed:

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

Response

Language

URL

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

application/xml