Skip to main content

Create payment gateway

To use custodial payment gateways, you need a verified Volet.com account. If you do not have one yet, see Create account, Business verification, or Personal verification.

Non-custodial payment integrations do not require a Volet.com account. Please contact our team for integration details.

Choose your integration method​

  • Use Hosted Checkout if you want the fastest integration with a ready-made payment page hosted by Volet.com. This is also the only integration method that supports payments from Volet.com account balances.
  • Use API if you want to build your own payment flow and fully control the customer experience.

Compare API vs Hosted Checkout vs Smart Contracts to choose the right integration method for your business.

note

You can update these settings at any time after creating the gateway.

Option 1: Create a Hosted Checkout gateway​

Step 1: Create a Hosted Checkout​

Log in to your Volet.com dashboard, go to Payment Tools and click Create at Hosted Checkout section.

Step 2: Configure payment methods​

On the first tab enable the payment methods you want to accept:

MethodDescription
Volet.com usersCustomers pay from their Volet.com account.
Crypto walletsCustomers pay in BTC, ETH, USDT, USDC, and other supported tokens from any crypto wallet.

More about each method:

For each method, configure Who pays fee — toggle whether the processing fee is deducted from the received amount (Merchant pays) or added on top for the customer (Buyer pays).

Step 3: Configure settings​

Configure your Hosted Checkout page and callback URLs.

Payment processing options​

  1. Use a digital signature in Hosted Checkout requests.

    Signs payment requests and callback notifications using your Hosted Checkout password. This helps verify that requests originate from Volet.com and have not been modified during transmission.

    We recommend keeping this option enabled in production environments.

  2. Accept underpayment.

    Allows orders to be completed when the customer sends less than the requested amount.

    This option can be useful for cryptocurrency payments where network fees, manual calculations, or exchange rate fluctuations may result in a slightly smaller payment than expected.

  3. Accept overpayment.

    Allows orders to be completed when the customer sends more than the requested amount.

    This option can be useful when customers accidentally transfer a larger amount than requested.

Hosted Checkout configuration​

  1. Hosted Checkout name. Name used to identify this Hosted Checkout inside your Volet.com account.

  2. Website, mobile app, bot, or AI agent URL. Provide the public URL associated with this payment gateway. This URL will also be displayed to customers during the payment process.

Examples:

  1. Notification email. Optional contact email associated with this Hosted Checkout configuration.

  2. Email displayed in Hosted Checkout. Reserved for future use.

  3. Hosted Checkout password. Secret key used to sign payment requests and verify callback notifications. Keep it private and do not expose it in client-side code.

Status URLs configuration​

Then configure callback and redirect URLs. You may omit these parameters and/or specify them in payment request form.

  1. Success URL. URL where customers are redirected after a successful payment.

  2. Failed URL. URL where customers are redirected if the payment fails or is cancelled.

  3. Status URL. Server endpoint that receives payment status notifications. Use these notifications to update order statuses automatically in your system.

For Success URL, Failed URL, and Status URL you can choose the HTTP method:

  • GET — parameters are sent in the query string.
  • POST — parameters are sent in the request body.

Step 4: Customize appearance (optional)​

Optional, can be set up later.

You can customize the Hosted Checkout page with your logo and brand colours.

Step 5: Approval​

Newly created gateways require administrator approval before they can accept live payments.

Approval typically takes a few hours.

You will receive an email notification when your gateway is approved and ready to use.

note

You cannot process live payments until your gateway is approved. Use this time to complete the integration on your site.

Step 6: Integrate Hosted Checkout​

Once approved, you can integrate Hosted Checkout into your website, application, bot, or AI agent.

See:Hosted Checkout integration

Option 2: Create an API gateway​

Step 1: Create an API gateway​

Log in to your Volet.com dashboard, go to Payment Tools and click Create in the API section.

Step 2: Configure API settings​

Configure the basic API settings.

  1. API name. Internal name of the API gateway. This name is used only inside your Volet.com account.

  2. IP whitelist. List of IP addresses allowed to access the API.

    You can:

    • Enter one or more IP addresses manually.
    • Click Add current IP to automatically add your current IP address.
    • Enable Allow all IPs to disable IP restrictions (not recommended for production environments).

  3. API password. Secret key used to authenticate API requests. Keep it private and do not expose it in client-side code.

  4. Website, mobile app, bot, or AI agent URL. Provide the public URL associated with this API integration.

Examples:

Step 3: Configure API permissions​

Choose which permissions will be available for this API gateway.

For payment acceptance integrations, enable:

  • Make transactions
    • Accept crypto payments — allows your application to create payment invoices and accept cryptocurrency payments from crypto wallets.
  • Find transaction — allows your application to retrieve payment status and transaction details after an invoice has been created.

API integrations do not use callback URLs. After creating an invoice, your application should use Find transaction to check the current payment status.

Additional permissions such as balance retrieval, transaction history, exchanges, and payouts can be enabled later if required by your integration. See API reference for more details.

Step 4: Approval​

Newly created API gateways require administrator approval before they can process live transactions.

Approval typically takes a few hours.

You will receive an email notification when your API gateway is approved and ready to use.

note

You cannot process live transactions until the API gateway has been approved.

Step 5: Integrate​

Once approved, you can start accepting payments through the API.

See:

  • API integration - how-to guide of API payment getaway integration.
  • API reference - complete methods, parameters, and response documentation.