Skip to content
Global Payments Oceania API Global Payments Oceania API

Classification Of Online Card Payments

Online card payments are defined by where the payment originates from and whether it is a once-off or repeat tranasaction. In the API, we use the category.origin and category.frequency fields to define this information.

category.origin

The category.origin parameter identifies the origin of the payment and will be one of the following:

  • internet - Used when a cardholder initiates an online payment. Eg. a standard ecommerce payment made through an online store.
  • mail or telephone - Used when the payment is initiated by the merchant instead of the customer. Eg. A merchant billing a cardholder for a recurring subscription.

category.frequency

The category.frequency parameter will determine whether the transaction is a singluar payment or a known customer making a recurring payment.

  • single - This is used when it is a customer making a standard online payment and entering their card details. Primarily used with a category.origin of internet. This combination requires the CVN to be present, as it is a cardholder initiated payment.
  • recurring - This is used to indicate that a transaction is for a known customer and not the first payment they have made to the merchant. When used with a category.origin of mail or telephone, the CVN will not be required, as the payment is initiated by the merchant.