Transaction Notification Format


Provided you include the notification_url parameter in your request the system will send a notification to your chosen endpoint in the following format:.

YOUR ENDPOINT?reply_code=604&reply_desc=Order%20is%20unique%20and%20must%20be%20used%20only%20once.&trans_id=22924&trans_date=11%2F02%2F2020%2012%3A40%3A11&trans_amount=7.23 &trans_currency=USD&trans_order=ABC12365&payment_details=VISA….1234&merchant_id=3783018&client_fullname=dim%20tester&client_phone=97223344556&client_email=you@email.com &signature=r5b25pouS4NvsjZ3ufmI2J1fJ%2FJ2rHnRnMkeybeHzHY%3D

ParameterDescription
reply_codeReply code provided from the system
reply_descThe reason for the decline as it is provided from the provider or by the system - for further info contact Support
trans_idThe transaction ID that is generate by our system
trans_dateThe time and date of the transaction - Time is set to GMT (URL Encoded)
trans_amountThe amount of the transaction that was processed
trans_currencyThe currency in which the transaction was processed. (ISO Code - USD/EUR/GBP)
trans_orderThe order id that was sent by the merchant to our system - the unique identifier on the merchant CRM system.
payment_detailsThis will return the payment method used and the last 4 digits on the card number if relevant
merchant_idThe company id as it was provided to the merchant by Support (Company Number)
client_fullnameThe full name of the client that was included in the transaction.
client_phoneThe phone number of the client that was included in the transaction.
client_emailThe email address of the client that was included in the transaction.
signaturebase64( hash('sha256', trans_id + trans_order + reply_code + trans_amount + trans_currency + merchanthash))

* Reply codes are either from system or from the providers we work with – list of declines may change from time to time.
** Approved reply code would always be 000 and Pending would be 553.
*** Please be sure to support POST on your end to receive the notifcation

Transaction Status


Service to request a transaction status – by default the service will return the PENDING transaction id that was sent given that this service was built for the purpose of checking 3DS transactions, you can adjust the RequestType field to “1” to receive all other types of transaction status.

Service URL

https://process.gr8pay.com/member/getStatus.asp

Request Fields

FieldRequiredDescription
CompanyNumYesYour merchant number - 5722306
TransIDYesID number of transaction
RequestTypeNoFor a non-pending transaction send "1"
https://process.gr8pay.com/member/getStatus.asp?CompanyNum=XXXXXXX&TransID=XXXX

Response Fields

FieldDescription
ReplyReply code (see list of possible reply codes of Silent Post)
ReplyDescReply description
TransIDID number of transaction

Response Format

Reply=XXX&ReplyDesc=Some Reply Description&TransID=XXXX

Transaction Status By Order


Service to request the response for a specific order id as configured on the merchant CRM system – Since there are cases where the Merchant might be using the same Order ID for multiple transactions, some approved some declined the service will return a JSON response holding all the relevant transactions found with that Order ID for that Merchant.

Service URL

https://process.gr8pay.com/member/getStatus.asp

Request Fields

FieldRequiredDescription
CompanyNumYesYour merchant number - 5722306
OrderYesID number of transaction
SignatureYesSignature creation algorithm is: base64(Hash("SHA256",CompanyNum + Order + MerchantHashKey))
Signature output example: ZaezsN+9xHWkLorQgtNW5M+fB6/lVP4SgtlUDwgBl+0=
https://process.gr8pay.com/member/getStatus.asp?Order=XXXXXXX&CompanyNum=XXXXXXX&signature=ZaezsN+9xHWkLorQgtNW5M+fB6/lVP4SgtlUDwgBl+0=

Response Fields

FieldDescription
ReplyReply code (see list of possible reply codes of Silent Post)
ReplyDescReply description
TransIDID number of transaction
trans_dateDate and time of the transaction
merchantIDCompany Number
trans_amountTransaction amount
trans_currencyTransaction currency
trans_typeTransaction type: 0 = Debit Transaction 1 = Authorization only 2 = Capture 3 = Charge stored credit card (pass the stored card ID in CcStorageID field)
trans_installmentsThe number of installments for the transaction.
client_fullNameCard holder full name
client_emailCard holder email
client_phoneNumCard holder phone number

Response Format

Response example in JSON format:
{ “error”:”0″, “message”:”SUCCESS”, “data”:[
{ “replyCode”:”004″, “replyDesc”:”Missing Customer Name Part”, “trans_id”:”19717″, “trans_date”:”28/01/2019 16:05:21″, “merchantID”:”XXXXXXX”, “trans_amount”:”1.23″, “trans_currency”:”USD”, “trans_type”:”0″, “trans_installments”:”1″, “client_fullName”:”test best”, “client_email”:”test@gr8pay.com”, “client_phoneNum”:”1212121212″ }

{ “replyCode”:”546″, “replyDesc”:”Previous transaction with this card is still in process, please try again after response is sent”, “trans_id”:”20″, “trans_date”:”21/08/2017 15:52:57″, “merchantID”:”XXXXXXX”, “trans_amount”:”10″, “trans_currency”:”USD”, “trans_type”:”0″, “trans_installments”:”1″, “client_fullName”:”test best”, “client_email”:”test@gr8pay.com”, “client_phoneNum”:”+0()1234567″ }

{ “replyCode”:”546″, “replyDesc”:”No details”, “trans_id”:”20″, “trans_date”:”21/08/2017 15:52:57″, “merchantID”:”XXXXXXX”, “trans_amount”:”10″, “trans_currency”:”USD”, “trans_type”:”0″, “trans_installments”:”1″, “client_fullName”:”bester tester”, “client_email”:”best@gr8pay.com”, “client_phoneNum”:”+0()1234567″ }

{ “replyCode”:”000″, “replyDesc”:”SUCCESS”, “trans_id”:”4091″, “trans_date”:”24/12/2017 21:03:04″, “merchantID”:”XXXXXXX”, “trans_amount”:”1″, “trans_currency”:”EUR”, “trans_type”:”0″, “trans_installments”:”1″, “client_fullName”:”TEST HOST CARD”, “client_email”:”tester1@gr8pay.com”, “client_phoneNum”:”” }
Or failed response example:
{ "error":"103", "message":"Failed On Authentication", "data":[] }