Stored Card Only

The transact API call processes a payment and optionally stores the card for future use.

This sample shows saving the card without processing a payment.

To save the card without processing a payment, set all of the request amount fields to zero and turn on the SaveCard flag. View the Sample Request tab for a complete example.

POST https://[your-terminal-ip]:8090/transact SessKey: [your-session-key] Content-Type: application/json

Response Status Codes

• 200 OK - Transaction submitted successfully. This does not mean the transaction was approved and processed; see the error handling section for more information.

• 401 Unauthorized - Missing or invalid SessKey

• 400 Bad Request - Invalid request format

• 500 Internal Server Error - Processing error

Error Handling

Please view our API Best Practices guide for information on handling errors, logging responses, and checking for declines.

Sample Request

{
  "MerchID": 2,
  "SaveCard": 1,
  "AcctHolder": {
    "Firstname": "Fred",
    "Lastname": "Smith",
    "Company": "",
    "Title": "",
    "Url": "",
    "BillingAddress": {
      "Address1": "1307 Broad Hollow Road",
      "Address2": "",
      "City": "",
      "State": "",
      "ZIP": "11747",
      "Country": "USA"
    },
    "Email": "[email protected]",
    "Phone": "8777248472"
  },
  "Amounts": {
    "BaseAmt": 0,
    "Surcharge": 0,
    "TotalAmt": 0,
    "ConfirmTotalAmt": false
  },
  "Refdata": {
    "ServiceDesc": "Throat Culture",
    "ClientRefID": "1876345",
    "RPGuid": "dcaa9ac0-71a8-4dd4-ad2f-fbe107d1e789",
    "POSUser": "Sally Smith"
  }
}

Sample Response

Header Parameters

Body