Unified Payments API Support & Integration Help

Request an invite from our team, then use your invite code to create an account. Add your website under Dashboard → Websites, create an API key under Developers, and set your webhook URL in Developers → Webhooks.

There is no sandbox and there are no test API keys: every API key creates real payments. To test end to end, create one real $1 payment with your API key and complete it, use the "Send test" button in Developers → Webhooks to check that your endpoint verifies the signature and answers HTTP 200, and call GET /api/payments/:paymentId/status to confirm the final status.

There is no separate test environment to graduate from: once your account and website are set up, your API key creates real payments. Your account manager confirms which payment methods are enabled for you.

Checkout can offer cards, digital wallets, local bank and payment apps, and crypto. The methods a customer sees depend on the methods enabled for your account, their country, the amount and their device. Your account manager confirms which methods are enabled for you.

FAILED means an attempt did not go through, not that the payment is closed. The customer can retry, and a PAID webhook can still arrive later, sometimes hours or days afterwards. Only PAID is final: always credit it, even after FAILED or CANCELLED.

Pending payments are awaiting confirmation. PENDING and PROCESSING are not sent as webhooks; you receive a webhook when the payment becomes PAID or FAILED. Use GET /api/payments/:paymentId/status to check it in the meantime.

Payment methods are enabled by our team during onboarding. Some methods need an additional review of your business or website before they can be switched on. Contact your account manager to request a method.

No. You integrate once with the VoltPay API, and routing between payment providers is handled by the platform.

VoltPay monitors provider availability. If a payment method is unavailable, checkout offers the customer the remaining methods enabled for your account.

Payouts are sent in USDT to the address on file for your account. Payout timing is arranged with your account manager, and Dashboard → Balances shows what is available to withdraw and your payout history.

Timing is agreed with your account manager. The status of each payout is shown in Dashboard → Balances.

Payout fees depend on your merchant agreement. Contact your account manager for the fees that apply to your account.

Not from the dashboard. Payout timing is agreed with your account manager.

Traffic to our API, dashboard and checkout is encrypted in transit with TLS. Card data is handled per PCI DSS requirements, and access to merchant data is restricted by role. See our Security page for details.

VoltPay processes personal data as described in our Privacy Policy. To request access to, correction of or deletion of your data, contact support.

All webhooks include an X-Webhook-Signature header with HMAC-SHA256 signature. Verify this signature using your webhook secret to ensure webhooks are from VoltPay.

Verify your API key is correct, active and not expired (after a rotation, the previous key stops working within 24 hours). Send it in the Authorization header as Authorization: Bearer <API_KEY>.

Check that your webhook URL is publicly accessible, does not redirect, and returns HTTP 200, 201, 202 or 204 within 20 seconds, and that the endpoint is not paused. Use "Send test" and the delivery history in Developers → Webhooks. Note that only PAID and FAILED are sent as webhooks; pending payments and unpaid expiries are not.

Pending status means the payment is awaiting confirmation. This usually resolves within minutes, but some payment methods take longer. A payment that is never completed expires, and a late PAID can still arrive after that.