Developers

A clean API and webhooks for real-world payment flows.

VallioPay gives you a straightforward REST/JSON API, sandbox keys for testing, and webhooks for every important event—so you can ship reliable payment flows without fighting the gateway directly.

Create sandbox account View API documentation →

🧪 Dedicated sandbox & live keys

📡 Webhooks for all key events

📜 Clear error codes & logs

POST /api/v1/payments 200 OK

curl -X POST https://api.valliopay.io/api/v1/payments \
  -H "Authorization: Bearer sk_test_123" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 1200.00,
    "currency": "SCR",
    "reference": "INV-2025-038",
    "customer": {
      "name": "Ocean View Apartments",
      "email": "billing@oceanview.sc"
    },
    "callback_url": "https://yourapp.sc/payments/callback"
  }'

Use your sandbox keys to test this request. v1 • JSON • Webhooks

Get started in three steps.

Set up VallioPay to fit your stack without a long integration project. Start small with payment links or wire it fully into your workflows.

Create sandbox account

Plug in your gateway

Add your existing card payment gateway credentials and confirm test transactions before going live.

Wire up your flows

Use VallioPay’s APIs and webhooks for checkouts, subscriptions, bookings, or ERP-driven collections.

API design

REST/JSON API with clear authentication and versioning.

VallioPay is built around a simple, consistent REST API so you don’t have to guess how endpoints work. All requests are JSON, authenticated with bearer tokens.

• Use separate sandbox and live keys to isolate environments.
• Versioned base URL: /api/v1/.
• Clear HTTP status codes and error payloads.
• Idempotency support for retrying requests safely.

POST /api/v1/payments
Authorization: Bearer sk_live_***

{
  "amount": 950.00,
  "currency": "SCR",
  "reference": "BOOKING-2847",
  "customer": {
    "name": "Island Retreat Guesthouse",
    "email": "accounts@islandretreat.sc"
  },
  "callback_url": "https://yourapp.sc/payments/callback"
}

Responses include a payment ID, status, and gateway reference so you can track each transaction end-to-end.

Webhooks

Keep your systems in sync with real-time events.

VallioPay webhooks let you respond to payment events without polling. Update your internal records, send notifications, or trigger fulfilment workflows as soon as something happens.

• Events for payment succeeded, failed, cancelled, and refunded.
• Separate webhook signing secret for each environment.
• Retries with backoff if your endpoint is temporarily unavailable.
• Dashboard logs for every webhook attempt and response.

POST https://yourapp.sc/webhooks/valliopay
X-Valliopay-Signature: t=1730123456,v1=...

{
  "id": "evt_01HRY9A3XK",
  "type": "payment.succeeded",
  "data": {
    "payment_id": "pay_01HRY89X8Q",
    "amount": 1200.00,
    "currency": "SCR",
    "reference": "INV-2025-038",
    "status": "succeeded"
  }
}

Validate the signature header using your webhook secret to ensure that events are genuinely sent by VallioPay.

Building blocks for your stack.

Use VallioPay as a simple payment layer, or integrate it deeply into your existing tools. The primitives stay the same; how far you go is up to you.

🌐 Websites & stores

Collect payments from your website or store by generating VallioPay links server-side and redirecting customers into the hosted experience.

📱 Mobile & booking apps

Trigger payment flows from your iOS, Android, or booking apps using the same API and deep links back to your interface when payments complete.

🧩 Back-office & ERPs

Generate payment links directly from your ERP, CRM, or internal tools, then sync statuses via webhooks and reconciliation exports.

Ship your first VallioPay integration in days, not months.

Start in sandbox, connect your gateway, and wire up webhooks. As you grow, VallioPay grows with you—without adding complexity to your codebase.

Get sandbox keys View pricing →