Card acquisition allows you to retrieve shopper details before creating a payment request, for example, to perform an eligibility check for tax-free shopping.
To acquire and use shopper details:
CardAcquisitionrequest, get the response and note the
The response contains shopper details if available. Currently only contact chip transactions are supported. The card should remain in the terminal after Card Acquisition has been completed to continue with the payment transaction.
Request a payment with the
POIData.POITransaction.TransactiondIDnoted above. The transaction is performed with the given card data, and will look like a regular payment. If a card acquisition reference is absent or incorrect, an error is reported.
For a list of CardAcquisitionRequest fields, see CardAcquisitionRequest fields. The elements of the request are wrapped in a
ServiceID in the
MessageHeader should be unique.
ServiceID combinations are rejected if used recently, within 48 hours.
Pass the following fields when making a
CardAcquisitionRequest call to the Terminal API.
Card Acquisition Response
For a list of Card Acquisition Response fields, see CardAcquisitionResponse fields.
The response contains information about the status of the request in the following fields:
After making a Card Acquisition request, continue with a payment request using the
POIData.POITransaction.TransactiondID returned in the card acquisition response. Here's an example of what that looks like:
Cancelling a request
Cancelling a card acquisition request involves making an
EnableService request. For more information, see Cancel card acquisition.