Integrate your ValorPayTech payment terminal with SalesPlay POS to process secure card payments directly from the POS. This integration eliminates manual entry on the payment terminal, improves transaction accuracy, and speeds up the checkout process.
Prerequisites
Before you begin, make sure you have:
- A SalesPlay Back Office administrator account.
- The latest SalesPlay POS app installed.
- A supported Valor payment terminal.
- The App ID and App Key provided by your Valor device provider.
- The EPI and Channel ID (if provided by the payment provider).
Step 1: Enable Payment Gateways in SalesPlay Back Office
- Log in to the SalesPlay Back Office.
- Navigate to:Settings → Features
- Locate Payment Gateways.
- Enable the feature.
- Click Save.
This enables payment gateway support for your account.
Step 2: Open Payment Gateway Settings
- Go to:Settings → Payment Gateways
- Click Add Payment Gateway.
Step 3: Add the Valor Payment Gateway
Complete the payment gateway configuration using the details supplied by ValorPayTech.
| Field | Description |
|---|---|
| Payment Gateway | Select Valor |
| Device Name | Enter a recognizable name for the terminal |
| Environment | Select Live |
| App ID | Provided by ValorPayTech |
| App Key | Provided by ValorPayTech |
| EPI | Enter if provided |
| Channel ID | Enter if provided |
| Target Terminals | Select the appropriate terminal(s) |
After entering all required information, click Save.
Important:
The App ID, App Key, EPI, and Channel ID are unique to your payment device. Enter them exactly as provided. Incorrect values will prevent the terminal from connecting.
Step 4: Assign Valor to the Card Payment Type
- Navigate to:Settings → Payment Types
- Open the Card payment type.
- Enable Payment Gateway.
- Scroll down to the Payment Gateway section.
- Select Valor.
- Click Update.
Step 5: Enable Valor on the POS App
On the SalesPlay POS device:
- Open the SalesPlay POS app.
- Tap the Menu (☰).
- Go to:Settings → Payment Gateway
- Verify that Valor is listed.
- Turn the Status toggle ON.
- Tap Save.
Verify the Integration
After completing the setup:
- Valor appears as an active payment gateway in the Back Office.
- The payment terminal is available on the POS.
- Card payments can be processed directly through the Valor terminal.
Troubleshooting
If the payment terminal does not connect:
- Verify the App ID and App Key are entered correctly.
- Ensure the Payment Gateways feature is enabled in the Back Office.
- Confirm the Valor terminal is powered on and connected.
- Sign out of the POS app and sign back in to refresh the settings.
Frequently Asked Questions
Which credentials are required?
The integration requires the App ID and App Key supplied by your Valor device provider. Some merchants may also receive an EPI and Channel ID.
Can I use multiple Valor terminals?
Yes. Each terminal can be added as a separate payment gateway using its own device credentials and assigned to the appropriate target terminal.
Which environment should I select?
Use the Live environment unless instructed otherwise by your Valor device provider.
Why isn’t Valor appearing on the POS?
Ensure:
- Payment Gateways are enabled in the Back Office.
- Valor is assigned to the Card payment type.
- Valor is enabled under POS Settings → Payment Gateway.
- The POS has been refreshed by signing out and back in.