Purchase - Using a Point of Sale (QorConnect)

Process a purchase through a point of sale system with or without QorConnect



This Purchase endpoint is unique because of the POS / Terminal and QorConnect parameters.


The following parameters are available to process a credit/debit card sale via QorConnect.

midthe Merchant ID (MID) assigned by QorCommerce or your merchant service provider (MSP)Yes
toptType Of Payment Transaction - set a value to simply tag and/or route a transaction to a pre-defined provider.No
reference_idA reference id that will be echo'd back in the message response.No
amountthe total amount to processYes
taxthe tax amount on the orderYes
ticketPOS ticket {object} (QorConnect) - (see ticket object parameters below)Yes
baddressthe card billing street addressNo
baddress2the card billing street 2 addressNo
bcitythe card billing city nameNo
bstatethe card billing state codeNo
bzipthe card billing zip codeNo
bcountrythe card billing country codeNo
currencyThe currency to process. Defaults to 'USD' if no value providedNo
ipaddressThe IP address of the client or server sending the requestNo
cfirstnamethe customer first nameNo
clastnamethe customer last nameNo
cemailthe customer email addressNo
cphonethe customer phone numberNo
send_rcptsend the customer a receipt to cemailNo
metadataa set of key-value pairs that you can attach to a payment. This can be useful for storing additional information about the payment in a structured format.No

The ticket object array provides the following paramters

terminal_idthe POS terminal idYes
clerk_numberunique employee idYes
check_numberthe POS ticket IDYes
payment_idthe payment ID from the POSYes
JSON Example

The following JSON example provides test values to process a QorConnect sale. You can copy and paste these values in the Body Params section below to be used by the Try It feature

  "transaction_data": {
    "mid": "887728202",
    "amount": "1.5",
		  "terminal_id": "3",
		  "clerk_number": "1002",
		  "check_number": "10001",
		  "payment_id": "POS_12345"
    "bzip": "92382",
    "baddress": "18312 All View Dr."
    "baddress2": "Apt 207",
    "bcity": "Running Springs",
    "bstate": "CA",
    "bcountry": "US",
    "cfirstname": "Russell",
    "clastname": "Hanneman",
    "cemail": "[email protected]",
    "cphone": "1-344-877-8928",
    "cwebaddress": "example.com",
    "send_rcpt": "true"

Response Codes

Link to details on related response codes.

Test Cards

The following sample credit card numbers should be used to get the expected responses:

Card NumberExp DateResponse
Click Try It! to start a request and see the response here!