Modify Pending Deposit Status

post

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

Use the Modify Pending Deposit Status endpoint to either post or return pending direct ACH deposits that are returned by Get Pending Deposits. This endpoint is intended for a custom fraud monitoring and resolution strategy. Consult with Galileo to configure your program appropriately.

For more information on this endpoint see Modifying a pending ACH deposit status in the ACH Endpoints guide.

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
543-01	Provided depositTransactionId doesn't map to any payment
543-02	Invalid category type. The valid choices are A=Approve, W=Watch and D=Decline.
543-03	Invalid action type. The valid choices are P=Post and R=Return.
543-04	Transaction is not in a status that can be posted or returned
543-05	Failed to Post transaction
543-06	Failed to Return transaction
543-07	Ret Code should not be used when posting
543-08	Ret Code is required when returning
543-09	Invalid Ret Code supplied. Valid Ret Codes: x
543-10	Payment successfully updated, but was not successfully marked as reviewed. Please contact client support for more details.
543-11	Failed to find transaction by depositTransactionId and or categoryCode. Please confirm both are correct.

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"

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"

depositTransactionId

int32

required

The ACH transaction identifier (ach_trans_id), as returned by the Get Pending Deposits endpoint.
Pattern: Integer
Example: 6844743

actionType

string

enum

required

Action to take on the pending deposit:

P — Post the deposit
R — Return the deposit to the sender. When returning the deposit, retCode is required

Pattern: String
Example: "P"

Allowed:

categoryCode

string

required

Category to assign to the deposit. See Deposit Category Codes for valid values.
Pattern: String
Example: "TAX"

categoryType

string

enum

required

Indicates the decision for future ACH deposits that match the program settings for the current deposit. Values are:

A — Approve matching transactions.
D — Decline matching transactions.
W — Watch matching transactions and send for manual review.

Pattern: String
Example: "D"

Allowed:

retCode

string | null

enum

Reason for returning the deposit. This parameter is required when actionType: R. See the Return Codes table for valid values.
Pattern: String
Example: "R02"

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

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