General info on using shopping carts with Ingenico epayments

Transcriptie

1

2 Inhoudsopgave 1. Disclaimer 2. What is a PSPID? 3. What is an API user? How is it different from other users? 4. What is an operation code? And should I choose "Authorisation" or "Sale"? 5. What is an SHA signature/passphrase? Page 1 of 6-09/09/2017

3 1. Disclaimer Copyright 2016 Ingenico epayments. Alle in deze teksten genoemde handelsmerken, servicemerken en handelsnamen zijn eigendom van de respectieve eigenaren. De hierin opgenomen informatie is verstrekt als service en is uitsluitend bedoeld ter informatie. Deze informatie is niet bedoeld als een volledige beschrijving van alle toepasselijke regels, beleidslijnen en procedures. De genoemde onderwerpen kunnen van tijd tot tijd veranderen, en individuele omstandigheden kunnen verschillen. Ingenico epayments kan niet aansprakelijk worden gesteld voor eventuele onjuiste of onvolledige informatie. De informatie in dit document bevat, onder andere, een compilatie van de ontvangen informatie van derden en deze informatie is en blijft eigendom van zijn respectieve eigenaar. Niets in deze voorstelling is bedoeld als aanvulling of wijziging van enig toepasselijk contract, regel of regelgeving. Ingenico epayments heeft veel aandacht besteed aan de inhoud van deze informatie, maar geeft geen verklaringen of garanties over de juistheid of volledigheid ervan. Noch Ingenico epayments noch zijn gelieerde bedrijven zijn aansprakelijk voor eventuele kosten, verliezen en/of schade voortvloeiend uit toegang tot of gebruikmaking van de inhoud van dit document. Vanwege de complexiteit van het proces en het recht van banken om voorwaarden te wijzigen, kan dit document uitsluitend dienstdoen als een beschrijving, waarbij verdere wijzigingen zijn voorbehouden. De in dit document genoemde extensie is ontwikkeld als een generieke oplossing. Ingenico epayments kan niet aansprakelijk worden gesteld voor eventuele schade als gevolg van de extensie. Indien de extensie door een gebruiker op enigerlei wijze wordt gewijzigd, kan Ingenico epayments niet aansprakelijk worden gesteld voor eventuele schade als gevolg van de gewijzigde extensie. De beschrijving van de extensie in dit document is slechts verstrekt als service, en Ingenico epayments geeft geen verklaringen of garanties over het gebruik of de werking van de extensie. Noch Ingenico epayments noch zijn gelieerde bedrijven zijn aansprakelijk voor eventuele kosten, verliezen en/of schade voortvloeiend uit toegang tot of gebruikmaking van de extensie. Page 2 of 6-09/09/2017

4 2. What is a PSPID? The PSPID is the unique identifier of your Ingenico epayments account. It is the ID you chose (or were given) at the registration of your Ingenico epayments account, and which you usually login with. When configured in your shopping cart, our system will use the PSPID to identify you as a registered merchant. Page 3 of 6-09/09/2017

5 3. What is an API user? How is it different from other users? Depending on your shopping cart, you may be asked for an API-user and password for the API-user. The API-user is a separate user you create in your Ingenico epayments Account. Its only purpose is to allow an application (your shopping cart) to create and/or maintain transactions on our platform. Unlike other users, you can't login with the API-user. Where in my Ingenico epayments account can I find this setting? In the main menu, go to "Advanced" > "Users", click "New user" and check "Special user for API". > More information on User Management Page 4 of 6-09/09/2017

6 4. What is an operation code? And should I choose "Authorisation" or "Sale"? In your shopping cart you may be requested to configure an operation code. This way you can choose how you want your credit card transactions to be processed; in two stages (Authorisation) or in one stage (Sale). If you use a different operation code in your shopping cart, this will override the default operation code in your account. Authorisation Sale The money is reserved on the customer's card. You need to confirm the transaction (within a certain period, depending on your acquirer contract), so the amount is taken from the customer's card. > We recommend this option if you don't have an automated stock system, if you work with reservations/bookings (such as for hotels), etc The money is taken instantly from the customer's card > We recommend this option if you provide an online service such as ticket sales, etc. Where in my Ingenico epayments account can I find this setting? In the main menu, go to "Configuration" > "Technical information" > "Global transaction parameters" > "Default operation code". Page 5 of 6-09/09/2017

7 5. What is an SHA signature/passphrase? The SHA signature is a data integrity check, that guarantees no one can tamper with the details of a transaction, e.g. to lower the amount. You need to enter a passphrase, a character string of your own choice, both in your shopping cart and in your Ingenico epayments account. SHA-IN passphrase SHA-OUT passphrase The SHA-IN verifies the data when they are submitted to the payment page. This is a mandatory check. The SHA-OUT works the same as the SHA-IN, only it is used to verify the data after the transaction is processed. Although the SHA-OUT check is not required, you are still obliged to enter a value for the SHA-OUT passphrase. Note: the SHA-IN/OUT passphrases must be different in your production and test account Where in my Ingenico epayments account can I find these settings? SHA-IN passphrase: go to "Configuration" > "Technical information" > "Data and origin verification" > "Checks for e-commerce" > More information about SHA-IN SHA-OUT passphrase: go to "Configuration" > "Technical information" > "Transaction feedback" > "Security for request parameters" > More information about SHA-OUT Page 6 of 6-09/09/2017