Set Account-Level Auth Control

post

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

Use the Set Account-Level Auth Control endpoint to create or modify an account-level velocity control. Prior to calling this endpoint, call Get Auth Control to get the controlId for the control to set or modify. See Set Velocity Controls for instructions on using this endpoint.

To update existing velocity ALCs, see Updating velocity ALCs.

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
599-01	`Failure, generic error, return values are invalid.` Contact Galileo for troubleshooting.
599-02	`Failure, control_id does not exist.` Use a valid value for `controlId`.
599-03	`Failure, prod_id is not configured to use specified control_id.` Call Get Auth Control with `prodId` populated to retrieve valid control_ids for this products.
599-04	`Failure, an optional parameter is required for update/insert`
599-05	`Failure, start_date is later than end_date`
599-06	`Failure, the amount and/or transaction-count values provided are in conflict with another ALC with the same PRN and control ID. The amount and transaction-count limits for an ALC without MCCs must be greater than or equal to the amounts and transaction counts of ALCs with MCCs. Please adjust the amount and/or transaction-count values.`
599-07	`Failure, the provided MCC range overlaps with an existing account-level MCC limit. Please use a different MCC range.` Call Get Auth Control with `accountNo` populated to retrieve existing ALCs.
599-08	`Failure, the provided MCC range overlaps with an existing account-level or product-level MCC control. Please use a different MCC range.` Call Get MCC Controls to retrieve existing MCC controls.

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

required

The PRN for the account. Do not use the CAD or PAN.
Pattern: 12-digit numeric string
Example: "344101254935"

controlId

int32

required

The control ID of the velocity control to set or modify, as returned by Get Auth Control.
Pattern: Integer, max 18 digits
Example: 10492

amount

float | null

The amount of the new limit. If this parameter is not populated when creating a new control, then transactionCount is required
Pattern: Decimal number (14, 2)
Example: 500.00

transactionCount

int32 | null

New number of transactions to permit. If this parameter is not populated when creating a new control, then amount is required.
Pattern: Integer, maximum 18 digits
Example: 5

startDate

date | null

Start date-time for the control. Can be set up to six months in the future. Cannot be in the past. Must be earlier than endDate. Default: Current Galileo system time
Pattern: YYYY-MM-DD hh:mm:ss or YYYY-MM-DD
Example: "2022-03-03 00:00:00"

endDate

date | null

End date-time for the control. Must be later than startDate. Cannot be in the past. Default: 3000-01-01 00:00:00.
Pattern: YYYY-MM-DD hh:mm:ss or YYYY-MM-DD
Example: "2022-03-10 23:59:59"

mccControls

array of strings | null

A list of one or more MCC ranges, including standalone values, to apply the velocity control to. Format is ['XXXX', 'YYYY-ZZZZ', 'AAAA-BBBB']. When updating a velocity control with an MCC range, specify the entire range: ['YYYY-ZZZZ']. Max 100 ranges.
Pattern: List of MCCs either alone or in a range.
Example: ['2000', '3000-3999', '4567']

mccControls

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

Loading…

Response

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

application/json

application/xml

Status codes

default