Examples: Host-Based

Sale

All values in Purple are either merchant specific or transaction specific values that have been made up for demonstration purposes.

REQUIRED FIELD VALUE
N TERMID TEST4444
N TYPE S
N PASS mypass
N CARD 5555444455554444
N EXP 0130
N AMT 1500
N REF SALE1234
CUSTNAME John Smith
CUSTEMAIL custname@email.com
INV EXAMPLE123
DESC Pointguard Tryouts

 

The CUSTNAME, CUSTEMAIL, INV , and DESC is used for reporting 

Request:
TERMID=TEST4444&TYPE=S&PASS=mypass&AMT=1500&REF=SALE1234&CARD=5555444455554444&EXP=0130&INV=EXAMPLE123&CUSTNAME=JohnSmith&CUSTEMAIL=custname@gmail.com&DESC=Pointguard Tryouts
Response:
TEXT=AB4113  $15.00&CODE=0000&AUTH=AB4113&TOKEN=9999RMQOVFO77328&HASH=8888CB657D49CC3BD26AED86B57999F9&DATE=2023-04-22&TIME=09:41:13&DUR=0.193

Sale with Decline

All values in Purple are either merchant specific or transaction specific values that have been made up for demonstration purposes.

REQUIRED FIELD VALUE
N TERMID TEST6666
N TYPE S
N PASS mypass
N CARD 5555444455554444
N EXP 0230
N AMT 1500
N REF NO123456
CUSTNAME Jane Jones
CUSTEMAIL custname@email.com
INV SPRTBALL123
DESC Spring T-ball

The CUSTNAME, CUSTEMAIL, INV , and DESC is used for reporting

Request:
TERMID=TEST6666&TYPE=S&PASS=mypass&AMT=10000&REF=NO123456&CARD=5555444455554444&EXP=0230&INV=SPRTBALL123&CUSTNAME=JaneJones&CUSTEMAIL=custname@gmail.com&DESC=Spring T-ball
Response:
TEXT=EXPIRED CARD   &CODE=1254

 

Note: The reason returned in the text field is not always specific and depends on the upstream financial institution

 

Sale - 2nd attempt

  • Note that there must always be a new REF value for each new transaction
  • The INV remains the same which allows grouping of the transactions that the customer processed (i.e. the declined transaction and this transaction)

All values in Purple are either merchant specific or transaction specific values that have been made up for demonstration purposes.

REQUIRED FIELD VALUE
N TERMID TEST6666
N TYPE S
N PASS mypass
N CARD 5555444455554444
N EXP 0230
N AMT 1500
N REF NO987654
CUSTNAME Jane Jones
CUSTEMAIL custname@email.com
  INV SPRTBALL123
  DESC Spring T-ball

The CUSTNAME, CUSTEMAIL, INV , and DESC is used for reporting

Request:
TERMID=TEST6666&TYPE=S&PASS=mypass&AMT=10000&REF=NO987654&CARD=5555444455554444&EXP=0231&INV=SPRTBALL123&CUSTNAME=JaneJones&CUSTEMAIL=custname@gmail.com&DESC=Spring T-ball
Response:
TEXT=J94118    $15.00&CODE=0000&AUTH=J94118&TOKEN=5674RMQOVFO77300&HASH=7650CB657D49DE3BD26AED86B5712KMN&DATE=2023-04-22&TIME=09:41:13&DUR=0.193

Return

All values in Purple are either merchant specific or transaction specific values that have been made up for demonstration purposes.

REQUIRED FIELD VALUE
N TERMID TEST4444
N TYPE R
N PASS mypass
N CARD 5555444455554444
N EXP 0130
N AMT 1500
N REF RETURN1234
CUSTNAME John Smith
CUSTEMAIL custname@email.com
INV EXAMPLE123

 

Including the INV from the original Sale transaction allows the Return to be ‘linked’ to the Sale in reporting

Request:
TERMID=TEST4444&TYPE=R&PASS=mypass&AMT=1500&REF=RETURN1234&CARD=5555444455554444&EXP=0130&INV=EXAMPLE123&CUSTNAME=John Smith&CUSTEMAIL=custname@gmail.com
Response:
TEXT=RETURN    $15.00&CODE=0000

Create Token

All values in Purple are either merchant specific or transaction specific values that have been made up for demonstration purposes.

REQUIRED FIELD VALUE
N TERMID TEST4444
N TYPE K
N PASS mypass
N CARD 5555444455554444
N EXP 0130
CUSTNAME John Smith
CUSTEMAIL custname@email.com

 

Request:
TERMID=TEST4444&TYPE=K&PASS=mypass&CARD=5555444455554444&EXP=0130&CUSTNAME=JohnSmith&CUSTEMAIL=custname@gmail.com
Response:
TEXT=TOKENOK&CODE=0000&TOKEN=1224KKBXQJN77328&HASH=LK80CB657D49CC3BD26AED86B57999F9&DATE=2023-04-24&TIME=10:05:53&DUR=0.155