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.

De documentatie voor ontwikkelaars is beschikbaar in het Engels.

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.