Skip to main content
Skip table of contents

Setup GIACT eCheck Verification

GIACT uses gVERIFY®, which provides real-time status updates for business or customer accounts to validate them before approving a deposit or accepting payment.

Getting Started

Before you begin running eCheck Verifications for Merchant transactions, you’ll want to set up a GIACT eCheck Verification Fee and apply it to the Merchant or add the Merchant to an existing Group with the fee set up.

Setting Up a GIACT eCheck Verification Fee to apply on a Merchant

Set up a new Group to apply the GIACT eCheck Verification Fee:

Step 1: On the Groups page, click ADD GROUP, enter the group name, then, click CREATE GROUP.


Apply the GIACT eCheck Verification Fee to the existing Group:

Step 2: From the Group Profile, click the Fees tab, then click ADD FEES to open an Add Fees lightbox.

Step 3: Set “When to trigger a fee?” to “GIACT eCheck Verification”, add the required info and click ADD.

Step 4: Return to the Group Profile, click ADD MEMBERS, select the Merchant, and click SAVE.

You can read more about Fee setups in the articles below:

The selected root page could not be found.

Now that you’re set up to apply the GIACT eCheck Verification Fee, you can begin running policy checks on transactions to apply automated risk decisions based on eCheck verification responses.


Reviewing GIACT Check Alerts for Merchants

API Request - Policy Run Summary

We have created the new endpoint (below) to run a GIACT policy check on a given transaction or set of transactions.

Base URL

https://apiv2.payrix.com/risk/v2

Endpoint

/decision/policy-run-summary

HTTP Method

GET

Full HTTP Request

https://apiv2.payrix.com/risk/v2/decision/policy-run-summary?stage=auth&transactionId={txn-id}

Required Header

Valid Values

Notes

Content-Type

application/json

Authorization

{yourAPIKey}

This can be found on the Portal Settings page.

login

{yourLoginID}

User your login ID that begins with t1_log_.

legacy-auth-header-name

APIKEY

Deprecated field, APIKEY is the valid value.

Query Parameter

Type

Required

Notes

{txn-id}

string

Required

Valid values are transactions that have taken place on the platform and follow the alphanumeric string format.

Example: t1_txn_12a3bc4de56f789012gh3ij

Note: The Transaction ID entered here will also appear in the subject field of your API call response within the results object.

The {txn-id} needs to be replaced with the given transaction ID which needs to be verified if GIACT was called and the response of GIACT call.

Tip: To run this call in the Sandbox, simply update the base URL to https://apiv2.stage.payrix.com/risk/v2. See Policy Run Summary Sandbox Testing below for more information.

Policy Run Summary Response Parameters

The expandable content below gives more in-depth information about the specific parameters available and required in the response body:

Click here to see details about all Response Body Parameters and applicable valid values.

Parameter

Description

Valid Values

uuid

The Universally Unique Identifier (ID) of the Transaction being reviewed.

the subject field will contain the transaction ID, the action will have and the decisionType field value will show GiactInquiry- displaying the reason for the action field value as BLOCK with the result field value being BLOCK within the results object.

policyUuid

The Universally Unique Identifier (ID) of the GIACT Policy

subject

The Transaction ID of the transaction in question.

action

The result of running the Policy.

results

Giact Inquirt Results Information

decisionType

Displays that the type of the decision, in this case always GiactInquiry.

result

The result of the final GIACT Inquiry decision.

BLOCK
PASS
SKIP

resultSummary

In case of failure this will contain the error summary.

Policy Run Summary Response Body Example

Click here to see a sample code snippet of a response.
JSON
{
    "uuid": "XXX7c-038a-4881-af7d-7c029e022bbd",
    "policyUuid": "XXX90c-6b40-40fe-90e7-406da5d70852",
    "subject": " {txn-id} ",
    "action": "BLOCK",
    "results": [
        {
            "decisionType": "GiactTxnInquiry",
            "result": "BLOCK"
        }     
    ] 
}

GIACT Alerts in the Portal

The GIACT Check alerts will be shown in the Alerts section of the Merchant Profile page of the Merchant performing the transaction.

Note: Only Facilitators can view the GIACT “Code” field from this page. Referrers and Merchants are unable to view the specific GIACT Check block code. Additionally, Payrix is not permitted to disclose the nature or reason for a GIACT response to Merchants or Referrers.

Below are the possible GIACT Inquiry Check response messages and the descriptions.

Message

Description

SKIP

The data submitted did not the meet initial requirements to begin a GIACT review.

BLOCK

The transaction data was reviewed with GIACT and has been declined with an assessed fee.

If a BLOCK is issued from a GIACT Inquiry Check, the Adverse Action Notice Requirement Message (shown below) will be displayed.

PASS

The transaction data was reviewed with GIACT and approved with an assessed fee.

Click here to view a copy of the Adverse Action Notice Requirement Message for GIACT Check.

Learn more about this declined transaction-

  1. Check if you have entered the correct bank account and routing details.

  2. Check if your bank account is in good standing.

  3. If the details are correct and are in good standing, This notice is intended to comply with the requirements of the federal Fair Credit Reporting (FCRA). We are unable to process your request because we were unable to verify or authenticate your account information. Our decision was based in whole, or in part, on information obtained from a consumer reporting agency, GIACT Systems, LLC. However, GIACT Systems, LLC played no part in the decision process and is unable to supply specific reasons for the denial of services. Under the FCRA, you have a right to know the information contained within your report. You also have a right to make a written request, no later than 60 days after you receive this notice, for disclosure of this information. You may request a free consumer report from GIACT Systems, LLC no later than 60 days following the receipt of this notice. You may also dispute information contained in the report if you believe that it is inaccurate or incomplete. GIACT Systems, LLC’s contact information is provided below: GIACT Systems, LLC 700 Central Expy S. Suite 300 Allen, TX 75013 1 (833) 802-8092”


Handling Unsuccessful eCheck (GIACT) Transaction

API Response - GIACT Transaction Status

Below is an example of the Status in Transaction Response for a failed transaction.

CODE
"city": "Pompano Beach",
"state": "FL",
"zip": "33069",
"country": "USA",
"phone": "0005290475",
"mid": "010495182",
"status": 2,
"refunded": 0,

Portal

For end-users, the transaction will initially be attempted. If the transaction is unsuccessful they will have to correct any incorrect or invalid data and try the transaction again.


Policy Run Summary Sandbox Testing

Creating a test transaction to execute a Policy Run Summary is done in two parts:

1. Create a new Transaction using testing trigger payment method values.

Process a POST request using the /txns endpoint, with the following values in the payment object within:

Click here for the /txns endpoint information

Base URL

https://api-test.payrix.com/

Endpoint

/txns

HTTP Method

POST

Full HTTP Request

https://api-test.payrix.com/txns

Required Header

Valid Values

Notes

Content-Type

application/json

 

Authorization

{yourAPIKey}

This can be found on the Portal Settings page.

login

{yourLoginID}

User your login ID that begins with t1_log_.

legacy-auth-header-name

APIKEY

Deprecated field, APIKEY is the valid value.

Click here for available transaction payment object sandbox testing triggers.

To receive a BLOCK action response from the GIACT eCheck Verification:

JSON
"payment": {
    "method": 9,
    "number": "0000000004",
    "routing": "122105278"
  }

To receive a HOLD action response from the GIACT eCheck Verification:

JSON
"payment": {
    "method": 9,
    "number": "0000000009",
    "routing": "122105278"
  }

To receive a RESERVE action response from the GIACT eCheck Verification:

JSON
"payment": {
    "method": 9,
    "number": "0000000001",
    "routing": "122105278"
  }

To receive a POST_REVIEW_ONLY action response from the GIACT eCheck Verification:

JSON
"payment": {
    "method": 9,
    "number": "0000000003",
    "routing": "122105278"
  }

2. Use the returned id response value to execute the Policy Run Summary

Click here for a copy of the endpoint information to test the Policy Run Summary

Base URL

https://apiv2.stage.payrix.com/risk/v2

Endpoint

/decision/policy-run-summary

HTTP Method

GET

Full HTTP Request

https://apiv2.stage.payrix.com/risk/v2/decision/policy-run-summary?stage=auth&transactionId={txn-id}

Query Parameter

Type

Required

Notes

{txn-id}

string

Required

The id value returned in the response body for part one above.

Example: t1_txn_12a3bc4de56f789012gh3ij

Required Header

Valid Values

Notes

Content-Type

application/json

 

Authorization

{yourAPIKey}

This can be found on the Portal Settings page.

login

{yourLoginID}

User your login ID that begins with t1_log_.

legacy-auth-header-name

APIKEY

Deprecated field, APIKEY is the valid value.

Result: You’ve now successfully created a test GIACT action response to either Block, Hold, or Reserve funds for a transaction, as well as allowing the transaction to process as normal, being marked for further review at a later time.

Example Response:

CODE
{
    "uuid": "XXX7c-038a-4881-af7d-7c029e022bbd",
    "policyUuid": "XXX90c-6b40-40fe-90e7-406da5d70852",
    "subject": "t1_txn_12a3bc4de56f789012gh3ij",
    "action": "BLOCK",
    "results": [
        {
            "decisionType": "GiactTxnInquiry",
            "result": "BLOCK"
        }     
    ] 
}

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.