Key Terms

General Merchant:

The merchant sells products to his customers, and receives a payment for it. In our language, the term includes also service providers, platforms, and marketplaces. As payment service provider (PSP), secupay cares for the payment and interacts with both, the merchant and his customer. The API offers an object called General Merchant to access merchant details.

General Contract:

Every merchant has a contract with secupay, or even multiple ones for different purposes. The API offers an object called General Contract to access the contract. The awkward details are managed behind the scenes by our system. What's important is that you will receive one or multiple General Contract IDs (GCR_xxx) and information how to use them. You need to manage to use the right contract ID for the right purpose.


A secucard is identified by a card ID, and can be secured by a card security code (CSC). There can be a physical card or not. The card may belong to a known card holder, or be used anonymously. It can be used for multiple merchants at the same time, having multiple loyalty programmes. Depending on the programme settings, it is used as personal loyalty card, gift card or discount voucher. Discount vouchers can be shared publicly as a marketing tool. There can also be acceptance points not belonging to the same merchant. The API object to mange the cards is called Loyalty Card.

Merchant Card:

The Merchant Card is an API object that manages the relation between the card, the merchant, the card programs and the acceptance points.

Loyalty Customer:

The Loyalty Customer is an API object, that can be associated to a Merchant Card to store the contact details of the card holder.

Smart Transaction:

A Smart Transaction manages a business transaction, like a purchase order for instance. If this includes one of our payment or loyalty services, it also manages the life cycle of the Payment Transaction or Loyalty Transactions. Furthermore it manages the checkout process, and can track the fullfilment of an order.