DocsOverview
  1. Docs

Build with VelPay

Three steps: create an order on your server, send the payer to its pay link, and fulfil when you receive order.paid.

La documentazione per sviluppatori è disponibile in inglese.

1. Get your keys

Sign up, then open Developers → API keys. Test keys start with vp_sk_test_ and never move real money; live keys start with vp_sk_live_ and work once your business is verified. Keep secret keys on your server.

2. Create an order

ShellPOST /api/v1/orders
curl https://velpay.pro/api/v1/orders \
  -H "Authorization: Bearer vp_sk_test_…" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: A-2041" \
  -d '{
    "amount": 12900,
    "currency": "eur",
    "reference": "A-2041",
    "payer": { "email": "buyer@example.com" },
    "success_url": "https://shop.example/thanks",
    "cancel_url": "https://shop.example/cart"
  }'

Amounts are integers in the currency's smallest unit (cents for EUR and USD). The response contains pay_link.

Redirect the browser to pay_link. The payer picks a method — card, Cash App or crypto — and pays. Afterwards they return to your success_url.

4. Fulfil on order.paid

Add an endpoint under Developers → Webhooks. We POST an event to it whenever something changes. Fulfil the order when you receive order.paid — never on the redirect alone.

Continue with the API reference, or follow a guide below.

Guides

Start

Payment methods

Integrations

Reference

WooCommerce plugin

Running a WooCommerce shop? Download the VelPay plugin and follow the install guide.