Consent Annual Older
This API call is for merchant accounts that are specifically configured for surcharge and/or convenience fee processing. Prior to charging a card on file, you may use this method to properly calculate the intended fees (Surcharging or Convenience fees ).
Fees will be calculated based on the merchant configuration and the card type itself. It is important to show the calculated fees at the point of sale so that a cardholder can reject the sale if they desire.
You can specify a Alternate MerchID rather than use the merchant record originally designated when you saved the card. A Value Of ZERO will use the original Merchant record.
Once you have determined your fees you can then call the method named : Charge Stored Card with Options to authorize the sale.
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.
A1842D663E9A4A72XXXXXXXX303541303234373138application/jsonapplication/jsonID for consent associated with the merchant account
7849Base $ amount for which fees are to be calculated
52ID of the merchant to collect the payment funds. Use 0 for the merchant on consent.
0Successful calculation of fees
POST /APIcardProcREST/v1.0.0/ConsentAnnual/CalcFees HTTP/1.1
Host: easypay5.com
SessKey: A1842D663E9A4A72XXXXXXXX303541303234373138
Content-Type: application/json
Accept: application/json
Content-Length: 51
{
"ConsentID": 7849,
"Amount": 52,
"AlternateMerchID": 0
}Successful calculation of fees
{
"ConsentAnnual_CalcFeesResult": {
"ErrCode": 0,
"ErrMsg": "",
"FunctionOk": true,
"RespMsg": "Fees calculated for CREDIT Card 4663XXXXXXXX2741",
"Amounts": {
"BaseAmt": 52,
"Surcharge": 1.04,
"TotalAmt": 53.04
}
}
}Use this call to Cancel a consent (Card On File). You will need the ConsentID in order to execute this method.
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.
A1842D663E9A4A72XXXXXXXX303541303234373138application/jsonapplication/jsonID of the consent to be canceled
20Successful cancellation of consent
POST /APIcardProcREST/v1.0.0/ConsentAnnual/Cancel HTTP/1.1
Host: easypay5.com
SessKey: A1842D663E9A4A72XXXXXXXX303541303234373138
Content-Type: application/json
Accept: application/json
Content-Length: 16
{
"ConsentID": 20
}Successful cancellation of consent
{
"ConsentAnnual_CancelResult": {
"CancelSuccess": true,
"CancelledConsentID": 20,
"ErrCode": 0,
"ErrMsg": "",
"FunctionOk": true,
"RespMsg": "Successfully DISBALED ConsentID 20 : Card Number Removed"
}
}This Method allows the user to charge a stored Card.
ConsentID Please supply the ID of the Consent ( or stored card data )
AlternateMerchID Here you can use ZERO if you plan to charge the same merchant record which was specified when saving the Card Info. You can use a positive integer if you plan to charge a merchant record which differs from the one originally used.
purchDetails If you want to attach new reference data to the transaction you may do so using the following fields:
ServiceDescrip : description of the transaction ClientRefID : your user defined reference ID RPGUID : another user defined reference ID If you choose NOT to supply these fields ( use empty string ) the system will pull this data from the original stored card data.
Amounts Here you will supply the amount of the transaction. You may supply FEES but only if these have been properly configured for each Merchant record.
If you don't have FEES configured simply supply the BaseAmt and TotalAmt.
If you do Have Fees Configured you can call the method named: Calculate Annual Consent Fees prior to calling this method.
You can specify fee values up to and including those determined using the above method.
If you specify values greater than those calculated above, then your value will be clamped.
IMPORTANT : Always check your response to determine the fees which are APPROVED as this may differ from what was REQUESTED.
User Here you can assign a user to the sale so that we record the person which is initiating the sale within the integrator software.
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.
A1842D663E9A4A72XXXXXXXX303541303234373138application/jsonapplication/jsonID of the consent (or stored card data)
8Use 0 for the original merchant record or a positive integer for a different merchant record
0The user initiating the sale. Used for reporting.
SamuelSuccessful charge of the stored card
POST /APIcardProcREST/v1.0.0/ConsentAnnual/ChargeStoredCard HTTP/1.1
Host: easypay5.com
SessKey: A1842D663E9A4A72XXXXXXXX303541303234373138
Content-Type: application/json
Accept: application/json
Content-Length: 205
{
"ConsentID": 8,
"Amounts": {
"BaseAmt": 52,
"Surcharge": 1.04,
"TotalAmt": 53.04
},
"purchDetails": {
"ServiceDescrip": "Annual Checkup",
"ClientRefID": "174356",
"RPGUID": "99438332"
},
"AlternateMerchID": 0,
"User": "Samuel"
}Successful charge of the stored card
{
"ConsentAnnual_ChargeStoredCardResult": {
"AVSresult": "Y",
"AcquirerResponseEMV": null,
"CVVresult": "",
"ErrCode": 0,
"ErrMsg": "",
"FunctionOk": true,
"IsPartialApproval": false,
"RequiresVoiceAuth": false,
"RespMsg": "APPROVED OK1400",
"ResponseApprovedAmount": 0,
"ResponseAuthorizedAmount": 53.04,
"ResponseBalanceAmount": 0,
"TxApproved": true,
"TxID": 37,
"TxnCode": "OK1400",
"ApprovedAmounts": {
"BaseAmt": 52,
"Surcharge": 1.04,
"TotalAmt": 53.04
}
}
}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.
A1842D663E9A4A72XXXXXXXX303541303234373138application/jsonapplication/jsonID of the consent to be modified
10Successful modification of annual consent
POST /APIcardProcREST/v1.0.0/ConsentAnnual/Modify HTTP/1.1
Host: easypay5.com
SessKey: A1842D663E9A4A72XXXXXXXX303541303234373138
Content-Type: application/json
Accept: application/json
Content-Length: 281
{
"ConsentID": 10,
"ConsentMods": {
"ExpMonth": 10,
"ExpYear": 22,
"Email": "[email protected]",
"Zip": "04106",
"CustomerRefID": "A1235456",
"ServiceDescrip": "REST API Testor",
"RPGUID": "adf98580-b4ab-42fc-bb99-01c89964afe9",
"NumDays": 365,
"LimitPerCharge": 10000,
"LimitLifeTime": 100000
}
}Successful modification of annual consent
{
"ConsentAnnual_ModifyResult": {
"ErrCode": 0,
"ErrMsg": "",
"FunctionOk": true,
"ModifySuccess": true,
"RespMsg": "Success : Modified Consent ID : 10"
}
}Last updated
Was this helpful?