Volet

What you need

In your Volet dashboard create a Hosted Checkout (the old "SCI") under Payment Tools → Hosted Checkout → Create. Three values go into your panel:

• Account e-mail (merchant_id): the e-mail address of your Volet account.
• SCI name (merchant_key): the "Hosted Checkout name" you chose (max. 50 characters).
• SCI secret (secret_key): the "Hosted Checkout password", the secret that signs requests and verifies notifications.

Keep "Use a digital signature in Hosted Checkout requests" enabled in the Hosted Checkout settings; the panel signs every request and rejects unsigned notifications.

In your panel choose Settings → Payments → Add method → Volet and enter the three values. A newly created Hosted Checkout takes no live payments until Volet approves it (usually a few hours).

Volet has no sandbox; test with a small real payment on the live account.

Callback URLs

The panel attaches its own URLs to every payment request (ac_status_url, ac_success_url, ac_fail_url), so nothing has to be entered in the Volet dashboard. You may still put this address into the Hosted Checkout's Status URL field:

https://<your-panel-domain>/payments/volet/callback

Status notifications are sent by POST; customer returns are GET. Volet limits every URL parameter to 100 characters; on a very long panel domain the payment reference is dropped from the return URL (crediting is unaffected, the return URL never credits).

If your server restricts inbound IPs, allow Volet's notification servers: 50.7.115.5, 51.255.40.139, 13.53.55.89. The panel verifies by signature, not by IP.

Flow

1. The customer enters an amount and picks Volet.
2. Their browser submits a signed form (ac_sign = SHA-256) to https://account.volet.com/sci/. The order id (ac_order_id) is our payment reference.
3. On Volet's page the customer picks a payment method: Volet account balance or a crypto wallet (USDT, USDC, BTC, ETH and others).
4. When the payment completes, Volet POSTs a server-to-server status notification to the panel's callback URL. The panel verifies ac_hash with the SCI password; if ac_transaction_status = COMPLETED, ac_amount is credited.
5. The customer clicks "Continue" and lands on the panel's "Add funds" page. That return only shows a banner, it never credits.

A second notification for the same transaction (ac_transfer) and status is ignored; balance is never credited twice.

Statuses

Volet ac_transaction_status	In the panel
COMPLETED	Completed, balance credited
PENDING, PROCESS	Pending (crypto confirmation in progress)
CANCELED	Failed

The payment memo records what Volet settled to your account (ac_merchant_amount, ac_merchant_currency) and the buyer's e-mail when present.

Currencies

Volet accepts these in a payment request: USD, EUR (fiat) and USDT, USDC, BTC, ETH, XRP, TRX, LTC, TON, SOL. Your panel's currency must be one of them; a TRY panel, for instance, cannot start a Volet payment. Fiat and stablecoin amounts are sent with 2 decimals, other crypto amounts with up to 8. The currency Volet settles to your account in ("settlement") is set in your Hosted Checkout configuration.

Common problems

• Volet's page reports a signature error: the account e-mail, SCI name or password in the panel does not match. All three must be exactly what the Hosted Checkout shows (the name is case-sensitive).
• Payment succeeded but no balance: the notification did not reach the callback URL (domain not yet pointed at us, no TLS, IP blocked) or was rejected because the SCI password is wrong. The record stays "pending" under Admin → Payments; verify the transaction in the Volet dashboard and complete it manually.
• "Volet accepts USD/EUR/…" error: the panel currency is not on Volet's list.
• Crypto payment pending for a long time: chain confirmations are still in progress; it completes automatically when Volet sends COMPLETED. If the customer underpaid and "Accept underpayment" is off in Volet, the payment will not complete.