VolgaPay API Documentation

This publicly available API provided by VolgaPay allows you to generate payment links anonymously without KYC. You can accept Credit/debit cards (including MasterCard, Visa, and Maestro), Apple Pay, Google Pay, SEPA or ACH local bank transfer.

You will receive instant payouts to your USDC (Polygon) wallet address once the customer pays using the link.

How It Works

• 1

  Generate Encrypted Wallet

  Create a temporary encrypted wallet address by passing your unique callback URL and USDC (Polygon) payout wallet.

• 2

  Redirect to Payment

  Redirect the customer to the payment page with the encrypted wallet address and payment details.

Standard Integration

Standard integration is for merchants who want to use the VolgaPay credit card system directly. You only need a valid crypto EVM wallet to access the system - it should be a self-custodial wallet to avoid any possible payout issues.

Create Wallet

This endpoint retrieves wallet control information by generating a temporary encrypted receiving wallet address.

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

{
  "address_in": "eE5A43DAkczRwxoW3IL7sGsRh6CiMx4kkTCccr6n%2FYMTGhy9b...",
  "polygon_address_in": "0x756C4D5EAad2165b3841a543Cf851Eed6AAF211B",
  "callback_url": "https://www.example.com/orders.php?number=8271468415326",
  "ipn_token": "ZEE2cW8zb1N0N2otZEc3eHh3MDNUU1lTMEExYmVvcDBVNl..."
}

Process Payment

This endpoint redirects the customer to the payment page. Treat this as the payment URL that your CMS should pass all required parameters to.

curl --location 'https://checkout.volgapay.com/process-payment.php?address=eE5A43DAkczRwxoW3IL7sGsRh6CiMx4kkTCccr6n%2FYMTGhy9b1eeIJLTr9Lho64fJTIeOfgsnJNNc%2FarqtR1jw%3D%3D&amount=103.78&provider=moonpay&email=john%40example.com&currency=USD'

Multi-provider Mode

This endpoint redirects the customer to a hosted page with multi-provider selection. Options are based on customer location, payment amount, and currency.

curl --location 'https://checkout.volgapay.com/pay.php?address=eE5A43DAkczRwxoW3IL7sGsRh6CiMx4kkTCccr6n%2FYMTGhy9b1eeIJLTr9Lho64fJTIeOfgsnJNNc%2FarqtR1jw%3D%3D&amount=103.78&email=john%40example.com&currency=USD'

List All Providers

Returns a full list of available payment providers with their minimum order values and status.

curl --location 'https://api.volgapay.com/control/provider-status'

Affiliate System

The affiliate system works the same way as the standard integration but allows sending and distributing payouts to multiple wallets. This is controlled at the encrypted wallet creation step.

Use Cases

• White-label the payment gateway with custom commission
• Earn the default 0.5% or custom commission as an affiliate
• Create advanced integrations with sub-merchants and sub-affiliates

Affiliate Create Wallet

Use this endpoint to white-label the payment gateway and earn commission on every sale by passing your affiliate wallet as an extra parameter.

curl --location 'https://api.volgapay.com/control/affiliate.php?address=0xF977814e90dA44bFA03b6295A0616a897441aceC&callback=https%3A%2F%2Fwww.example.com%2Forder%3Fnumber%3D82176413628089&affiliate=0x3c783c21a0383057D128bae431894a5C19F9Cf06'

Custom Affiliate Commission

For advanced white-labeling with custom commission distribution between merchant and affiliate wallets.

curl --location 'https://api.volgapay.com/control/custom-affiliate.php?address=0xF977814e90dA44bFA03b6295A0616a897441aceC&callback=https%3A%2F%2Fwww.example.com%2Forder%3Fnumber%3D82173313628090&affiliate=0x3c783c21a0383057D128bae431894a5C19F9Cf06&affiliate_fee=0.01&merchant_fee=0.91'

Sub-Affiliate

For advanced setups with merchant, affiliate, and sub-affiliate commission distribution.

curl --location 'https://api.volgapay.com/control/custom-sub-affiliate.php?address=0xF977814e90dA44bFA03b6295A0616a897441aceC&callback=https%3A%2F%2Fwww.example.com%2Forder%3Fnumber%3D82173313628090&affiliate=0x3c783c21a0383057D128bae431894a5C19F9Cf06&sub_affiliate=0x89630237D79B49Ba90c485AA7F8003D23F76c64b&affiliate_fee=0.02&sub_affiliate_fee=0.01&merchant_fee=0.89'

Mass Payout

Split payouts across up to 19 wallets. Useful for multiple wallet mass payouts, advanced rebrand, and variable fees per merchant.

{
  "callback": "https://www.example.com/order/?invoice=unique_invoice_id",
  "fees": {
    "0x89630237D79B49Ba90c485AA7F8003D23F76c64b": 0.01,
    "0xa557CEC455324d3A665491cFE85F0e88030D8775": 0.04,
    "0x026BEB2e88989beBC5e4Dabf957CAEC8999a2277": 0.06,
    "0xc08A4D184A021385b787c7881eEd73B2d379e796": 0.30,
    "0xF977814e90dA44bFA03b6295A0616a897441aceC": 0.51
  }
}

curl --location 'https://api.volgapay.com/control/mass-payout.php' \
--header 'Content-Type: application/json' \
--data '{
  "callback": "https://www.example.com/order/?invoice=unique123",
  "fees": {
    "0x89630237D79B49Ba90c485AA7F8003D23F76c64b": 0.01,
    "0xF977814e90dA44bFA03b6295A0616a897441aceC": 0.91
  }
}'

Currency Conversion

Some providers (wert, Stripe, Transfi, rampnetwork) support USD only. Use this endpoint to convert amounts to USD.

curl --location 'https://api.volgapay.com/control/convert.php?from=EUR&value=1258.31'

{
  "status": "success",
  "value_coin": "1351.76",
  "exchange_rate": "1.07427"
}

Callback Event

When a payment is made, our bot will visit your callback URL using GET request method. All your original parameters will be included plus payment data.

Callback Parameters

Example Callback

https://www.example.com/orders.php?number=827746841326
  &value_coin=105.6
  &coin=polygon_usdc
  &txid_in=0xa22a82b4aefbc55f6382e1b5c0b4f0e3c034a654...
  &txid_out=0x94c2c3e84c2021e6bf377aebf8abf03b49570611...
  &address_in=0x32e854bD1270670C832634CA87858fFd9F3e2c78
  &value_forwarded_coin=104.016

Check Payment Status

Use this endpoint to check the payment status when needed.

curl --location 'https://api.volgapay.com/control/payment-status.php?ipn_token=YOUR_IPN_TOKEN'

{
  "status": "paid",
  "value_coin": "117.59",
  "txid_out": "0xe85ed56174785b0bb9fcb522655f961675ad236...",
  "coin": "polygon_usdc"
}