GAgalileo-ft
Account-Level Controls

Set Account-Level Auth Control

Changed on

Use the Set Account-Level Auth Control endpoint to create or modify an account-level velocity control. Prior to calling this endpoint, call <a href="ref:post_getauthcontrol" target="_blank">Get Auth Control</a> to get the controlId for the control to set or modify. See <a href="doc:set-velocity-controls" target="_blank">Set Velocity Controls</a> for instructions on using this endpoint.

To update existing velocity ALCs, see <a href="doc:set-velocity-controls#updating-velocity-alcs" target="_blank">Updating velocity ALCs</a>.

post/setAccountLevelAuthControl

Request

  • Base URL
    api-{corename}.{env}.gpsrv.com/intserv/4.0/ (relative, and the document’s source URL is not known)
  • URL
    api-{corename}.{env}.gpsrv.com/intserv/4.0/setAccountLevelAuthControl
  • Auth
    none declared

Request body application/x-www-form-urlencoded

accountNostring required

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

amountnumber nullable

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

apiLoginstring required

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

apiTransKeystring required

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

controlIdinteger required

The control ID of the velocity control to set or modify, as returned by <a href="ref:post_getauthcontrol" target="_blank">Get Auth Control</a>. Pattern: Integer, max 18 digits Example: 10492

endDatestring date nullable

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"

mccControlsstring[] nullable

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']

startDatestring date nullable

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 <a href="ref:system-time" target="_blank">system time</a> Pattern: YYYY-MM-DD hh:mm:ss or YYYY-MM-DD Example: "2022-03-03 00:00:00"

transactionCountinteger nullable

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

transactionIdstring required

Supply a globally unique ID to identify this endpoint request ("transaction"). Might be used for <a href="ref:idempotency#endpoints-that-use-transactionid-for-idempotency" target="_blank">idempotency</a>. A UUID is preferred. Pattern: Maximum 60 characters Example: "9845dk-39fdk3fj3-4483483478"

Example request

{
  "accountNo": "344101254935",
  "amount": 500,
  "apiLogin": "AbC123-9999",
  "apiTransKey": "4sb62fh6w4h7w34g",
  "controlId": 10492,
  "endDate": "2024-03-10 23:59:59",
  "mccControls": [
    "2000",
    "0900-3000",
    "4567"
  ],
  "startDate": "2024-03-03 00:00:00",
  "transactionCount": 5,
  "transactionId": "123e4567-e89b-12d3-a456-426614174000"
}

Response

Successful response

errorsstring[]

A list of errors generated while the request was processed

processing_timenumber nullable required

The time elapsed in processing the transaction

response_dataobject required

A structure for the response data. This endpoint does not return response data, so it will always be empty.

rtokenstring nullable required

A system-generated ID used for tracking

statusstring nullable required

The condition of a process or response

status_codeinteger nullable required

The response status code. May return a string for some statuses.

system_timestampstring date-time nullable required

A system generated timestamp

Changes

  • 1ede7567a879Revision changes
    • breaking

      the request property's minLength was increased from 0 to 1

    • warning

      the request property's maxLength was set to 60

    • info

      the request property format was generalized from float to no format

    • info

      the request property format was generalized from int32 to no format

    • info

      the request property format was generalized from int32 to no format

    • info

      added the success response with the status