Create Adjustment

post

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

Use the Create Adjustment endpoint to move funds into or out of a customer account. Transactions using this endpoint are returned by the Get Account Overview endpoint only after several seconds have elapsed. To drive an account negative using this endpoint, set the ALWNB parameter at the provider level.

🚧
Warning
This endpoint requires a positive integer less than 9223372036854775807 (sys.maxint in Python 2 or sys.maxsize in Python 3) for transactionId rather than the alphanumeric string that all other endpoints use. The Reverse Adjustment endpoint uses this integer to identify the transaction to reverse out.

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
409-01	`The transactionId parameter must be an integer value`. Verify that `transactionId` is a positive integer less than 9223372036854775807 (`sys.maxint` in Python 2 or `sys.maxsize` in Python 3).
409-02	`Cardholder not configured for overdraft`. The cardholder account is not participating in overdraft. `featureType 17` must be `P`.
409-03	`Cardholder product not configured for overdraft`. The `prod_id` for this account does not support overdraft.
409-04	`Insufficient overdraft funds`. The account supports overdraft, but there are not enough funds in the overdraft account for this transaction.
409-05	`Error transferring overdraft funds`. The system attempted to transfer funds from the overdraft account to cover the amount of this transaction, but it failed.
409-06	`Cardholder overdraft configuration error`. The overdraft account is not configured for adjustments.
409-07	`Insufficient balance for cascading transaction`. Product settings (ALWNB) do not permit this endpoint to drive the account negative.
409-08	`The transactionId parameter must less than or equal to 23 char`.
409-09	`Transaction limit exceeded`.

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

int64

required

1 to 60

A unique integer ID for the transaction.
Pattern: 64-byte integer
Example: 164736451002

accountNo

string

required

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

amount

float

required

0.01 to 999999999999.99

Currency amount as a whole or decimal amount.
Pattern: Positive integer or decimal number
Example: 100.00, 100, or 100.73

type

string

required

The transaction type for the adjustment. Use the values provided by Galileo for your program.
Pattern: 1- or 2-character alphanumeric, case-sensitive
Example: "le"

description

string | null

Description for the transaction.
Pattern: 1–40 alphanumeric characters, including punctuation
Example: "One time payroll load."

debitCreditIndicator

string

enum

required

Specifies whether this transaction credits or debits the account in accountNo:

C — Credit
D — Debit

Pattern: String
Example: "D"

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"

locationType

int32 | null

enum

Type of ID in location:

0 — Galileo location ID
1 — Partner location ID
2 — Don't validate

Pattern: Integer
Example: 0

Allowed:

verifyOnly

string | null

enum

Pass 1 to test the validity of the parameter data without committing the information to the Galileo system.
Pattern: Integer
Example: 0

Allowed:

includeRtfTransfer

string | null

enum

Specifies whether the amount in this transaction should be transferred to or from the RTF funding account that is associated with this RTF spending account. Default: 1

0 — Do not perform an RTF transfer for this amount
1 — Perform an RTF transfer for this amount.

Pattern: Integer
Example: "1"

Allowed:

disputeId

string | null

External dispute ID, to be used by dispute providers only.
Pattern: 1-16 alphanumeric characters
Example: "21010000000D"

enforceTransactionLimits

int32 | null

enum

Pass 1 to enforce any adjustment transaction limits.
Pattern: Integer
Example: 0

Allowed:

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

Status codes

default