Consent Annual
Queries related to annual consent
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.
A1842D663E9A4A72XXXXXXXX303541303234373138
application/json
application/json
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).
(G=1)&&(B>'10/20/2024')
POST /APIcardProcREST/v1.0.0/Query/ConsentAnnual HTTP/1.1
Host: easypay5.com
SessKey: A1842D663E9A4A72XXXXXXXX303541303234373138
Content-Type: application/json
Accept: application/json
Content-Length: 37
{
"Query": "(A=-1)&&(G=1)&&(H='True')"
}
Successfully returned consent records
{
"ConsentAnnual_QueryResult": {
"Consents": [
{
"AcctHolderFirstName": "JOHN",
"AcctHolderID": 1,
"AcctHolderLastName": "DOE",
"AcctNo": "1111",
"AuthTxID": 15,
"CreatedBy": "John_Doe",
"CreatedOn": "2024-12-01 11:19:01",
"CustID": 15,
"CustomerRefID": "A12345NO-99",
"EndDate": "2024-12-01 11:19:01",
"ID": 12,
"IsEnabled": true,
"LimitLifeTime": 1000000,
"LimitPerCharge": 1000000,
"MerchID": 1,
"NumDays": 365,
"RPGUID": "adf98580-b4ab-42fc-bb99-01c89964afe9",
"ServiceDescrip": "",
"StartDate": "2024-12-01 11:19:01"
}
],
"ErrCode": 0,
"ErrMsg": "",
"FunctionOk": true,
"NumRecords": 2,
"RespMsg": "Successfully Returned Consent Records : 2"
}
}
Use this call to determine if the purchaser has a card on file. If you have created the consent (card on file) using a reference ID or PatientID then you can use the following Query to return an array of Consents ( Card On File Info ) for a particular patient with this PatientID: F='213456')&&(H=1)&& (C>='01/21/2024') This will return consents with a particular PatientID which are still enabled and have not yet expired ( use todays date ).
You will want to present the user with the last 4 digits of each stored card so they can decide to choose a stored card or simply enter a new one. Easy Pay offers multiple ways of querying consent data. View the https://easypaysoftware.com/en/Querying Query Guide for more details.
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.
A1842D663E9A4A72XXXXXXXX303541303234373138
application/json
application/json
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).
(G=1)&&(B>'10/20/2024')
POST /APIcardProcREST/v1.0.0/ConsentAnnual/QueryApr HTTP/1.1
Host: easypay5.com
SessKey: A1842D663E9A4A72XXXXXXXX303541303234373138
Content-Type: application/json
Accept: application/json
Content-Length: 61
{
"Query": "(A=1)&&(J='07e77e99-b16e-4b0f-8935-8d28e3fa28ef')"
}
Successfully returned consent records
{
"ConsentAnnual_Query_AprResult": {
"Consents": [
{
"AcctFirstName": "MTIP08-1 DMC 13A",
"AcctLastName": "MTIP08-1 DMC 13A",
"AcctMask": "5457XXXXXXXX0012",
"CardExpDate": "1225",
"CardType": "MC",
"ConsentType": "S",
"CreatedOn": "2024-12-01 11:19:01",
"CustomerRefID": "197",
"EndDate": "2024-12-01 11:19:01",
"ExpiredConsent": false,
"ID": 386,
"IsEnabled": true,
"LimitLifeTime": 1000,
"LimitPerCharge": 100,
"MerchID": 1,
"ModifiedOn": "2024-12-01 11:19:01",
"RPGUID": "adf98580-b4ab-42fc-bb99-01c89964afe9",
"Remaining": 1000,
"StartDate": "2024-12-01 11:19:01"
}
],
"ErrCode": 0,
"ErrMsg": "",
"FunctionOk": true,
"NumRecords": 1,
"RespMsg": "Successfully Returned Consent Records : 1"
}
}
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.
A1842D663E9A4A72XXXXXXXX303541303234373138
application/json
application/json
ID of the consent
12
POST /APIcardProcREST/v1.0.0/Query/ConsentAnnual_FullDetail HTTP/1.1
Host: easypay5.com
SessKey: A1842D663E9A4A72XXXXXXXX303541303234373138
Content-Type: application/json
Accept: application/json
Content-Length: 16
{
"ConsentID": 12
}
Successfully returned full detail for consent
{
"ConsentAnnual_FullDetailResult": {
"AccounttHolder": {
"AccountNum": "wj8HlAYlMJI=jvje9l7qZuEFiDDeEDDym6ZdlL0DX8HX",
"AcctMask": "4111XXXXXXXX1111",
"Address1": "123 Fake St",
"Address2": "",
"CardType": "VI",
"City": "PORTLAND",
"Company": "",
"CreatedOn": "2024-12-01 11:19:01",
"Email": "[email protected]",
"ExpDate": "1023",
"Firstname": "Sean",
"ID": 1,
"LastChanged": "2024-12-01 11:19:01",
"LastName": "Wood",
"MerchID": 1,
"Phone": "8777248472",
"State": "ME",
"Zip": "04106"
},
"ConsentAnnual": {
"AcctHolderFirstName": "JOHN",
"AcctHolderID": 1,
"AcctHolderLastName": "DOE",
"AcctNo": "1111",
"AuthTxID": 15,
"CreatedBy": "vidya_Venkatraman",
"CreatedOn": "2024-12-01 11:19:01",
"CustID": 15,
"CustomerRefID": "A12345NO-99",
"EndDate": "2024-12-01 11:19:01",
"ID": 12,
"IsEnabled": true,
"LimitLifeTime": 1000000,
"LimitPerCharge": 1000000,
"MerchID": 1,
"NumDays": 365,
"RPGUID": "adf98580-b4ab-42fc-bb99-01c89964afe9",
"ServiceDescrip": "",
"StartDate": "2024-12-01 11:19:01"
},
"EndCustomer": {
"Address1": "123 Fake St.",
"Address2": " ",
"City": "PORTLAND ",
"ClientRefID": "A123456",
"Company": "",
"CreatedOn": "2024-12-01 11:19:01",
"Email": "[email protected]",
"Firstname": "Sean",
"ID": 72,
"LastChanged": "2024-12-01 11:19:01",
"LastName": "Wood",
"MerchID": 1,
"Phone": "8777248472",
"Service": "",
"State": "ME ",
"Zip": "04106 "
},
"ErrCode": 0,
"ErrMsg": "",
"FunctionOk": true,
"RespMsg": "Successfully Returned Full Detail For Consent ID : 12"
}
}
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.
A1842D663E9A4A72XXXXXXXX303541303234373138
application/json
application/json
ID of the consent
2
The type of receipt
- 1: Transaction
- 2: Void
- 3: Refund
- 4: Annual Consent
- 5: Recurring Consent
- 6: Subscription
- 7: ACH Transaction
- 8: ACH Void
- 9: ACH Refund
2
Possible values: POST /APIcardProcREST/v1.0.0/Query/ConsentAnnualReceipt HTTP/1.1
Host: easypay5.com
SessKey: A1842D663E9A4A72XXXXXXXX303541303234373138
Content-Type: application/json
Accept: application/json
Content-Length: 31
{
"ConsentID": 2,
"ReceiptType": 1
}
Successfully returned annual consent receipt
{
"ConsentAnnualReceiptQryResult": {
"ErrCode": 0,
"ErrMsg": "",
"FunctionOk": true,
"ReceiptHtml": "<!DOCTYPE html>\n<html xmlns=\"http://www.w3.org/1999/xhtml\">\n<head runat=\"server\">\n<meta name=\"viewport\" content= width=device-width, initial-scale=1 />\n<title></title>\n</head>\n<body>\n<form id=form1 runat=server>\n<div style=font-size:12px;font-family:Verdana align=center>\n<h3>SALE RECEIPT</h3>\n<br />\n<div>\n<label>REA010 RETAIL</label>\n<br />\n<label>1307 BROAD HOLLOW ROAD</label>\n<br />\n<label>ANYWHERE, ME 11747</label>\n<br /><label></label>\n</div><br /> <br />\n<table style=text-align:left>\n<tr>\n<td>CARDHOLDER NAME:</td>\n<td><label>Wood, Sean</label></td>\n</tr>\n<tr>\n<td>ACCT NUMBER:</td>\n<td><label>x1118</label></td>\n</tr>\n<tr>\n<td>EXP DATE:</td>\n<td><label>xxxx</label></td>\n</tr>\n<tr>\n<td>TX ID:</td>\n<td><label>4117</label></td>\n</tr>\n<tr>\n<td>SEQ:</td>\n<td><label>5981</label></td>\n</tr>\n<tr><td>APPROVAL CODE:</td><td><label>OK5100</label></td></tr>\n<tr>\n<td><label>PATIENT</label> REF ID:</td>\n<td><label>12456</label></td>\n</tr>\n<tr>\n<td>TX DATE:</td>\n<td><label>12/13/2024 9:10:44 AM</label></td>\n</tr>\n<tr>\n<td>CARD TYPE:</td>\n<td><label>VI</label></td>\n</tr>\n<tr>\n<td>ENTRY METHOD:</td>\n<td><label>ManualEntry</label></td>\n</tr>\n<tr>\n<td>AMOUNT:</td>\n<td><asp:label runat=server>$10.00</asp:label></td>\n</tr>\n<tr>\n<td></td>\n<td><asp:label runat=server></asp:label></td>\n</tr>\n<tr>\n<td>TOTAL(USD):</td>\n<td><label>$10.00</label></td>\n</tr>\n</table>\n<br />\n<div>\n<label>THANK YOU FOR YOUR PATRONAGE</label><br />\n<label>All Sales Final</label><br />\n<div><label>I agree to pay REA010 RETAIL the above amount according to card issuer agreement.</label></div>\n<br /><br />\n<div><label>SIGNATURE</label></div>\n<br />\n<div>___________________________________</div>\n<h3><b>MERCHANT COPY</b></h3>\n</div>\n</div>\n</form>\n</body>\n</html>\n",
"RespMsg": "Successfully Returned Transaction Receipt Markup"
}
}
Last updated
Was this helpful?