# Overview

The fee to be applied to a transaction depends on the following:

  • Categories currently supported: Card-present, Keyed-in, E-commerce/Invoicing, Custom Type, E-check
  • Actions supported: Auth, Sale, Void, Refund

Note

The pricing that gets applied will depend on the contract between Poynt and the merchant. The following article details how to declare a transaction type in order to levy the rate as per the merchant contract. Please contact your account manager or the developer support team for more details on this.

# Terminal Transaction (Card-Present)

This category includes the transactions that are processed on the device and the card is present for the payment. The pricing is determined based on the criteria that the card has been used for payment and the funding source is CREDIT_DEBIT.

The entryMode would depend on if the card used is an EMV Chip Card or a Magnetic Stripe Card (MSR) and whether the payment is contactless or not. These have been shown below:

# EMV Card:

"entryDetails": {
      "customerPresenceStatus": "PRESENT",
      "entryMode": "INTEGRATED_CIRCUIT_CARD"
},
"type": "CREDIT_DEBIT"

# Contactless EMV Card:

"entryDetails": {
      "customerPresenceStatus": "PRESENT",
      "entryMode": "CONTACTLESS_INTEGRATED_CIRCUIT_CARD"
},
"type": "CREDIT_DEBIT"

# Magnetic Stripe Card (MSR):

"entryDetails": {
      "customerPresenceStatus": "PRESENT",
      "entryMode": "TRACK_DATA_FROM_MAGSTRIPE"
},
"type": "CREDIT_DEBIT"

# Contactless Magnetic Stripe Card (MSR):

"entryDetails": {
      "customerPresenceStatus": "PRESENT",
      "entryMode": "CONTACTLESS_MAGSTRIPE"
},
"type": "CREDIT_DEBIT"

# Keyed Transaction

This category includes the transactions that are processed on the device and via the virtual terminal on the web, or through an interface where the card is keyed in. The pricing is determined based on the criteria that the card number has been manually entered and the funding source is CREDIT_DEBIT.

"entryDetails": {
      "customerPresenceStatus": "VIRTUAL_TERMINAL_PRESENT",
      "entryMode": "KEYED"
},
"type": "CREDIT_DEBIT"

# E-commerce/Invoicing Transaction

This category includes the transactions that are processed on the web, for e.g. via Poynt Collect or the Invoicing app. The pricing is determined based on the criteria that the card number has been manually entered and the funding source is CREDIT_DEBIT.

# For Invoicing app transactions:

"entryDetails": {
      "customerPresenceStatus": "INVOICING",
      "entryMode": "KEYED"
},
"type": "CREDIT_DEBIT"

# For Poynt Collect transactions:

"entryDetails": {
      "customerPresenceStatus": "ECOMMERCE",
      "entryMode": "KEYED"
},
"type": "CREDIT_DEBIT"

# Custom Type Transaction

This category is to be used when you need a certain online transaction to have a different fee than others. The display name and rate for this fee can be configured from your Reseller portal as part of defining your sign up profile and rates. The pricing is determined based on the criteria that the card number has been manually entered and the funding source is CREDIT_DEBIT. It is important to note that the "customType" field within the "references" element must have the value "CUSTOM".

Note

Please note that this is not available to you by default and you would need to reach out to your account manager for details and to request for it.

# For Invoicing app transactions:

      "entryDetails": {
            "customerPresenceStatus": "INVOICING",
            "entryMode": "KEYED"
      },
      "type": "CREDIT_DEBIT"
},
"references": [
      {
            "id": "e1cb771c-1078-0010-88a1-43abc12ba121",
            "customType": "CUSTOM",
            "type": "CUSTOM"
      }
],

# For Poynt Collect transactions:

      "entryDetails": {
            "customerPresenceStatus": "ECOMMERCE",
            "entryMode": "KEYED"
      },
      "type": "CREDIT_DEBIT"
},
"references": [
      {
            "id": "e1cb771c-1078-0010-88a1-43abc12ba121",
            "customType": "CUSTOM",
            "type": "CUSTOM"
      }
],

# E-check Transaction

This category includes the transactions that are processed for e.g. using an ACH account. The pricing is determined based on the criteria that the card number has been manually entered and the funding source is CHEQUE.

"entryDetails": {
      "customerPresenceStatus": "ECOMMERCE",
      "entryMode": "KEYED"
},
"type": "CHEQUE"
Last Updated: 2/3/2021, 12:41:19 PM