Setup & Documentation — Sanval Payments

1. Install

Upload the plugin zip under Plugins → Add New → Upload Plugin, then activate. WooCommerce 7.0+ and PHP 8.1+ are required. The gateway is HPOS-compatible and supports both the classic and block-based checkout.

2. Configure your bank

Go to WooCommerce → Settings → Payments → Card (Payten/NestPay) and enter the details your bank provided:

Bank — pick your bank, or Custom / Other to enter endpoints manually.
Client ID and Store Key — issued by your bank's virtual POS team.
Gateway URL — your bank's 3-D Secure endpoint (the est3Dgate URL).
Currency — e.g. 949 (TRY), 941 (RSD), 978 (EUR).
Advanced — Hash Algorithm (ver3 default) and Store Type (3d_pay_hosting default). Leave defaults unless your bank specifies otherwise.

Test first. Turn Test Mode on and run an order with your bank's test card before going live. In test mode all features (including installments) are unlocked.

3. Installments (taksit)

Set Max installments above 1 to offer installment plans at checkout. Installments are a premium feature — active with a valid licence (and always in test mode). Core single-payment card processing always works.

4. Go live

Switch Test Mode off and place one real low-value order to confirm the live flow end-to-end. Refunds (full or partial) are issued from the order screen.

5. Getting support for your bank

Hit a wall? The plugin has a one-click diagnostic export (under the gateway settings). It produces an encoded record of the exact bank exchange — no card data, no secrets.

Reproduce the issue once.
Open the diagnostics panel and copy the latest record.
Email it to [email protected].

We read the exact bank response and reply with the fix. That setup help and ongoing support — plus installments, every bank preset and refunds — is what your licence pays for.

Troubleshooting

"Missing oid" or "already paid"

Usually a security or coming-soon plugin (e.g. password protection) is intercepting the bank's return callback to /sanval-3ds and turning it into a redirect. Allowlist that URL or disable the interfering plugin during checkout.

Console shows a cached script error

After updates, hard-refresh the admin (Ctrl+Shift+R) to clear the browser cache.

Setup & configuration