Espago transaction terminal - set up

Introduction

This internal internal article will show you how to configure Espago terminals with PosWeb and DI.

Before you start 

Production: https://terminals.espago.com/

Testing: https://terminals-sandbox.espago.com/ 

You need to have Espago Terminals browser add-on and application installed. 

Please prepare a user account with access to PosWeb application. We will use the credentials to authorize back request from Espago.

How it works?

1. Start the transaction from PosWeb by clicking on the Credit card button as standard credit card payment and send a request to Device Integrator. After that, Device Integrator performs a request to Espago API.
2. As a result of the request, Espago returns a unique url for payment. This url is then passed to PosWeb. Next, PosWeb opens that link in a new browser tab.
3. Espago connects with transaction terminal / simulator through the browser add-on. All of instructions will be displayed on the terminal screen.
4. Espago performs back request to PosWebApi with transaction status and details.
5. The status is saved in a Receipt entity related with the current transaction.
6. PosWeb (UI) receives the information about status of the payment and performs a request to Device Integrator which is waiting for transaction status.

Image

Instruction

Espago terminals configuration

1. Go to https://terminals.espago.com/ and sign in
2. Click edit service and provide integration data with instructions below:  
   Image

   
   Image

   

   

Api password: use the password generated to use with Espago API

Back request url: the url where Espago has to do a request and wait for code 200 response. It always looks according to the following pattern:

For production environment: https://CompanyName.perfectgym.pl/PosWebApi/api/espago/notifypaymentresult

For testing environment: https://CompanyName.testing1.perfectgym.pl/PosWebApi/api/espago/notifypaymentresult

Back login: NotifyPaymentResult method from PosWebApi requires login and password to authorize the request. It can be login and password of any user with access to PosWeb

Back pass: password of the user mentioned above

Positive url: the site to which user will be redirected after a successful payment

Negative url: the site to which user will be redirected after a failed payment

Espago Terminals application configuration

Go to Espago documentation for detailed configuration.

PosWeb configuration  

1. Go to the PosWeb and open the config tab.

2. In the TransactionTerminal section, select Espago terminal device and provide terminal id from Espago website. In this section, you also could set if credit card must be saved and tokenization in system what enables to recuring payment with the card. If payment finish successes user gives a question if save the card.

Image

3. Click Save configuration and restart Device Integrator