Complete guide: how to integrate Omniwallet with Ágora TPV

What does this integration allow?

The integration between Ágora POS and Omniwallet allows:

• Identify the customer at the physical point of sale.

• Capture purchase amounts so that Omniwallet automatically assigns the corresponding points.

• (Coming soon) Allow the customer to redeem their accumulated points for rewards or discount euros.

Connect Ágora POS with Omniwallet

Activate additional modules in Ágora POS

To enable the integration, it is necessary to activate additional modules in Ágora POS.

1. Access the Ágora Monitor.

2. Go to the menu:
   Tools → Activate Additional Modules

3. The module activation screen will be displayed.
   

Configure integration services

1. Check the option “Activate Integration Services Module”.

2. Click on “Configure Integration Services”.

3. A popup will open where you must complete the following data:

General configuration

• Select “Enable integration via HTTP API”.

• Create an API Token in your Omniwallet account.

  If you don't know how to do it, check the guide: How to create an API Token?

• Paste the API Token in the “Key” field.

• Select “Enable integration with loyalty system”.

Integration URLs with Omniwallet

URL for participant validation

Enter the following URL:

https://api.omniwallet.cloud/agora/member/{member_id}?_token=API_TOKEN&ow_account=SUBDOMINIO

• API_TOKEN → API Token generated in Omniwallet.

• SUBDOMINIO → subdomain of your Omniwallet account.

URL for purchase submission

Enter the following URL:

https://api.omniwallet.cloud/agora/invoices?_token=API_TOKEN&ow_account=SUBDOMINIO

• API_TOKEN → API Token generated in Omniwallet.

• SUBDOMINIO → subdomain of your Omniwallet account.

4. Click on “Accept” to save the configuration.
   
   

How to identify a customer at the point of sale?

Before processing the sale:

1. Ask the customer to show their Omniwallet loyalty card.

2. On the Ágora POS screen, click on the “Add Loyalty” button.
   
   

Reading the customer identifier

1. A tab will open to enter the identifier.

2. Hover over the empty field.

3. Scan the QR code or barcode from the customer's card with the scanner.

4. The identifier will be automatically filled in.

On the screen, you will be able to verify:

• The customer's name.

• The amount of accumulated points.
  
  

Automatic point assignment

Once the sale is completed:

• Ágora POS sends the complete purchase information to Omniwallet.

• Omniwallet registers the transaction.

• The corresponding points are automatically assigned to the customer.

The points balance is updated in real time.