VolgaPay

API Documentation

Payment Gateway API

Accept payments anonymously without KYC. Receive instant payouts to your USDC (Polygon) wallet. Support for Credit/Debit Cards, Apple Pay, Google Pay, SEPA, and ACH transfers.

Getting Started

The VolgaPay API allows you to generate payment links and accept payments from customers worldwide. The integration process requires two main steps:

  1. Generate a wallet using the Create Wallet endpoint by providing your USDC (Polygon) wallet address and a callback URL.
  2. Redirect customers to the payment page using the encrypted wallet address and payment details.
Important: You must create a unique encrypted wallet for each customer. Reusing the same wallet address will result in blocking.

Key Features

Instant Payouts

Receive payments directly to your USDC (Polygon) wallet instantly

No KYC Required

Generate payment links anonymously without identity verification

Multiple Payment Methods

Accept credit cards, Apple Pay, Google Pay, SEPA, and ACH transfers

White-Label Support

Customize the payment page with your own branding and domain

Affiliate System

Earn commissions on every transaction through our affiliate program

Multi-Provider

Support for multiple payment providers with automatic selection

API Endpoints

GETCreate Wallet

Generate a temporary encrypted wallet address for receiving payments.

⌄

Endpoint URL

https://api.volgapay.com/control/wallet.php

Parameters

address
The wallet address to receive instant payouts after customer payment. Wallet must be a valid USDC (Polygon).
Example: 0xF977814e90dA44bFA03b6295A0616a897441aceC
callback
URL-encoded callback URL where payment confirmation will be sent using GET request.
Example: https://www.example.com/orders.php?number=8271468415326

cURL Example

bash
curl --location "https://api.volgapay.com/control/wallet.php?address=0xF977814e90dA44bFA03b6295A0616a897441aceC&callback=https%253A%252F%252Fwww.example.com%252Forders.php%253Fnumber%253D8271468415326"

Response Example

json
{"address_in":"eE5A43DAkczRwxoW3IL7sGsRh6CiMx4kkTCccr6n%2FYMTGhy9b1eeIJLTr9Lho64fJTIeOfgsnJNNc%2FarqtR1jw%3D%3D","polygon_address_in":"0x756C4D5EAad2165b3841a543Cf851Eed6AAF211B","callback_url":"https://www.example.com/orders.php?number=8271468415326","ipn_token":"ZEE2cW8zb1N0N2otZEc3eHh3MDNUU1lTMEExYmVvcDBVNlVBcEl5Y01RcmFTMUtpbExHX0V2QTJucXpQRVdGRnQ3dzhmUVhYZUE%3D"}
GETProcess Payment

Redirect the customer to the payment page to complete the payment.

⌄

Endpoint URL

https://checkout.volgapay.com/process-payment.php

Parameters

address
The encrypted address_in generated from Create Wallet endpoint.
Example: eE5A43DAkczRwxoW3IL7sGsRh6CiMx4kkTCccr6n%2FYMTGhy9b1eeIJLTr9Lho64fJTIeOfgsnJNNc%2FarqtR1jw%3D%3D
amount
Amount the customer needs to pay. For example: 103.78
Example: 103.78
provider
Payment provider ID. Possible values: moonpay, stripe, transfi, etc.
Example: moonpay
email
URL-encoded customer email address.
Example: john@example.com
currency
Currency code (USD, EUR, CAD, etc.).
Example: USD
GETMulti-Provider Mode

Redirect customer to a hosted page with multiple payment provider options.

⌄

Endpoint URL

https://checkout.volgapay.com/pay.php

Parameters

address
The encrypted address_in generated from Create Wallet.
Example: eE5A43DAkczRwxoW3IL7sGsRh6CiMx4kkTCccr6n%2FYMTGhy9b1eeIJLTr9Lho64fJTIeOfgsnJNNc%2FarqtR1jw%3D%3D
amount
Amount the customer needs to pay.
Example: 103.78
email
URL-encoded customer email address.
Example: john@example.com
currency
Currency code (USD, EUR, CAD, etc.).
Example: USD
domain
(Optional) Custom domain for white-labeling.
Example: checkout.volgapay.com
GETAffiliate Create Wallet

Create a wallet with affiliate commission support.

⌄

Endpoint URL

https://api.volgapay.com/control/affiliate.php

Parameters

address
The wallet address to receive instant payouts.
Example: 0xF977814e90dA44bFA03b6295A0616a897441aceC
callback
URL-encoded callback URL for payment confirmation.
Example: https://www.example.com/order?number=82176413628089
affiliate
Affiliate wallet address to receive commission.
Example: 0x3c783c21a0383057D128bae431894a5C19F9Cf06
GETConvert to USD

Convert any currency to USD for providers that support USD only.

⌄

Endpoint URL

https://api.volgapay.com/control/convert.php

Parameters

from
The source currency code (EUR, SEK, etc.).
Example: EUR
value
The amount to convert.
Example: 1258.31

Response Example

json
{"status":"success","value_coin":"1351.76","exchange_rate":"1.07427"}
GETCheck Payment Status

Check the status of a payment using the IPN token.

⌄

Endpoint URL

https://api.volgapay.com/control/payment-status.php

Parameters

ipn_token
The IPN token received from the Create Wallet endpoint.
Example: ZEE2cW8zb1N0N2o2ZDJ1LTFoQTZRVFFObTBwTE9wQXJFYjBYcnBEQWJ4dkxYQXk0aExpeUFfWmt3Zi1NUlNJUzlxZDdlUm1WTDdMbEdJNlNOU1lmREVEXzJqLS1zYVZjMGY4OTBQbTNoWkxWQm1qSW5NeFg2ZE5NRmpxUV9OODR6cTBFQVMyd08wZVkzdEFoUlpBV25MbE81eHFKS2NoOU43eENfM2s%3D

Response Example

json
{"status":"paid","value_coin":"117.59","txid_out":"0xe85ed56174785b0bb9fcb522655f961675ad236f2aad2f5bb4fa2f074ac09726","coin":"polygon_usdc"}

Callback Events

When a payment is completed, VolgaPay will send a GET request to your callback URL with the following parameters:

value_coin
Amount of USDC paid by the provider
coin
Payout coin type (polygon_usdc or polygon_usdt)
txid_in
Polygon transaction ID of the payment
txid_out
Instant payout transaction ID to your merchant wallet
address_in
The polygon address that received the payment
value_forwarded_coin
Total amount forwarded to merchant and affiliates

Best Practices

Unique Wallets per Customer

Always create a new encrypted wallet for each customer transaction. Reusing wallets will get blocked.

Unique Callback Parameters

Include unique identifiers (order ID, invoice number) in your callback URL to track payments accurately.

Use IPN Tokens for Tracking

Store the IPN token from wallet creation to check payment status and investigate failed callbacks with support.

Validate Callback Amounts

Always verify the value_coin parameter matches your expected amount before updating order status.

Handle Affiliate Commissions

If using affiliate features, ensure affiliate_fee + merchant_fee = 0.92 (our service fee is 8%).

Support Multiple Currencies

Some providers (Stripe, Transfi) only support USD. Use the Convert to USD endpoint when needed.

Need Help?

If you have questions or need assistance with the API integration, please contact our support team.