Consent General

Queries related to all types of consent

Consent General Query

Query general consent records using specific filter criteria.

post

/APIcardProcREST/v1.0.0/Query/ConsentGeneral

Header parameters

SessKeystringrequired

A unique session key used for authentication in API calls. This key is generated upon successful authentication and must be included in all subsequent requests.

Example: A1842D663E9A4A72XXXXXXXX303541303234373138

Content-Typestringrequired

Example: application/json

Acceptstringrequired

Example: application/json

Body

Querystring

A query string for obtaining specific consent records using Number's query language. Build logical terms and join them with '&&' for logical AND or '||' for logical OR. Use single quotes for text and date values. Refer to the variable chart for query composition:

• A: MERCHANT ID - The merchant record you are interested in, e.g. (A=1).
• B: START DATE - The date the consent becomes active, e.g. (B>='10/20/2024').
• C: END DATE - The date the consent expires, e.g. (C<='10/20/2024').
• D: ACCOUNT HOLDER LAST NAME - Last name of the account holder, e.g. (D LIKE '%MITH') for all names that end with 'MITH'.
• E: CREATED ON - The date the consent was created, e.g. (E<='10/20/2024').
• F: CUSTOMER REFERENCE ID - User-defined value on the consent.
• G: CONSENT TYPE - The type of consent, e.g. (G='-1').
  • -1: ALL
  • 1: ANNUAL
  • 2: ONE-TIME
  • 3: RECURRING
  • 4: SUBSCRIPTION
• H: ENABLED - Indicates whether the consent is currently enabled, e.g. (H=1).
• J: RPGUID - User-defined value on the consent.
• K: ACCOUNT HOLDER FIRST NAME - First name of the account holder, e.g. (K LIKE 'ROB%') for all names that start with 'ROB'.
• Z: CONSENT ID - The unique identifier for the consent, e.g. (Z=15875).

Example: (G=1)&&(B>'10/20/2024')

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://easypay5.com/APIcardProcREST/v1.0.0/Query/ConsentGeneral' \
  --header 'SessKey: A1842D663E9A4A72XXXXXXXX303541303234373138' \
  --header 'Content-Type: application/json' \
  --header 'Accept: application/json' \
  --data '{"Query":"(A=-1)&&(G=1)&&(E>='3/29/2023')&&(E<'4/29/2023')"}'

200

200

{
  "ConsentGeneral_QueryResult": {
    "ErrCode": 0,
    "ErrMsg": "",
    "FunctionOk": true,
    "NumRecords": 1,
    "RespMsg": "Successfully Returned Consent Records : 1",
    "Consents": [
      {
        "AcctHolderFirstName": "Sean",
        "AcctHolderID": 1140,
        "AcctHolderLastName": "Tester",
        "AcctNo": "0055",
        "AuthTxID": 2175,
        "ConsentType": "S",
        "CreatedBy": "Sally_Smith",
        "CreatedOn": "/Date(1549947600000-0500)/",
        "CustID": 1165,
        "CustomerRefID": "A1523644",
        "EndDate": "/Date(1549947600000-0500)/",
        "ID": 568,
        "IsEnabled": true,
        "MerchID": 1,
        "ModifiedBy": ":",
        "ModifiedOn": "/Date(1549947600000-0500)/",
        "NumDays": 2107,
        "RPGUID": "adf98580-b4ab-42fc-bb99-01c89964afe9",
        "ServiceDescrip": "REST Test",
        "StartDate": "/Date(1549947600000-0500)/"
      }
    ]
  }
}

Successful response with consent records.

Consents Expiring Cards

Retrieve consents associated with cards that are expiring within a specified number of days.

post

/APIcardProcREST/v1.0.0/Query/ConsentsExpiringCards

Header parameters

SessKeystringrequired

A unique session key used for authentication in API calls. This key is generated upon successful authentication and must be included in all subsequent requests.

Example: A1842D663E9A4A72XXXXXXXX303541303234373138

Content-Typestringrequired

Example: application/json

Acceptstringrequired

Example: application/json

Body

NumDaysinteger

The number of days within which the cards are expiring.

Example: 20

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://easypay5.com/APIcardProcREST/v1.0.0/Query/ConsentsExpiringCards' \
  --header 'SessKey: A1842D663E9A4A72XXXXXXXX303541303234373138' \
  --header 'Content-Type: application/json' \
  --header 'Accept: application/json' \
  --data '{"NumDays":20}'

200

200

{
  "ConsentsExpiringCardsResult": {
    "ErrCode": 0,
    "ErrMsg": "",
    "FunctionOk": true,
    "NumRecords": 3,
    "RespMsg": "",
    "Consents": [
      {
        "AcctHolderFirstName": "Bruce",
        "AcctHolderID": 78,
        "AcctHolderLastName": "Wayne",
        "AcctNo": "5439",
        "CardExpDate": "/Date(1549947600000-0500)/",
        "CardExpDateMMYY": "1228",
        "ConsentType": "S",
        "CreatedBy": "Savannah_Tester",
        "CreatedByOrigin": "API",
        "CreatedOn": "/Date(1549947600000-0500)/",
        "CustID": 77,
        "CustomerRefID": "modify",
        "EndDate": "/Date(1549947600000-0500)/",
        "ID": 55,
        "IsEnabled": true,
        "MerchID": 3,
        "ModifiedOn": "/Date(1549947600000-0500)/",
        "RPGUID": "adf98580-b4ab-42fc-bb99-01c89964afe9",
        "ServiceDescrip": "API Modify",
        "StartDate": "/Date(1549947600000-0500)/"
      }
    ]
  }
}

Successful response with consents for expiring cards.

Consents Expiring Cards 01

Retrieve consents for cards expiring within a specified date range.

post

/APIcardProcREST/v1.0.0/Query/ConsentsExpiringCards_01

Header parameters

SessKeystringrequired

A unique session key used for authentication in API calls. This key is generated upon successful authentication and must be included in all subsequent requests.

Example: A1842D663E9A4A72XXXXXXXX303541303234373138

Content-Typestringrequired

Example: application/json

Acceptstringrequired

Example: application/json

Body

StartDatestring · date

The start date of the expiration period.

Example: 7/10/2023

EndDatestring · date

The end date of the expiration period.

Example: 8/9/2023

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://easypay5.com/APIcardProcREST/v1.0.0/Query/ConsentsExpiringCards_01' \
  --header 'SessKey: A1842D663E9A4A72XXXXXXXX303541303234373138' \
  --header 'Content-Type: application/json' \
  --header 'Accept: application/json' \
  --data '{"StartDate":"7/10/2023","EndDate":"8/9/2023"}'

200

200

{
  "ConsentsExpiringCards_01Result": {
    "ErrCode": 0,
    "ErrMsg": "",
    "FunctionOk": true,
    "NumRecords": 1,
    "RespMsg": "",
    "Consents": [
      {
        "AcctHolderFirstName": "Bruce",
        "AcctHolderID": 78,
        "AcctHolderLastName": "Wayne",
        "AcctNo": "5439",
        "CardExpDate": "/Date(1549947600000-0500)/",
        "CardExpDateMMYY": "1228",
        "ConsentType": "S",
        "CreatedBy": "Savannah_Tester",
        "CreatedByOrigin": "API",
        "CreatedOn": "/Date(1549947600000-0500)/",
        "CustID": 77,
        "CustomerRefID": "modify",
        "EndDate": "/Date(1549947600000-0500)/",
        "ID": 55,
        "IsEnabled": true,
        "MerchID": 3,
        "ModifiedOn": "/Date(1549947600000-0500)/",
        "RPGUID": "adf98580-b4ab-42fc-bb99-01c89964afe9",
        "ServiceDescrip": "API Modify",
        "StartDate": "/Date(1549947600000-0500)/"
      }
    ]
  }
}

Successful response with consents for expiring cards in the specified range.