Without PSP — International

Accept Festivalcadeau giftcard payments worldwide via our direct API. No payment gateway required.

How It Works

For international partners (or Dutch partners who prefer a direct integration), we offer a direct API that lets you devalue Festivalcadeau giftcards from your own checkout — no PSP needed.

  1. Build a payment option
    Add a "Pay with Festivalcadeau" button or form in your checkout
  2. Collect card details
    Customer enters their card number and PIN code
  3. Call our API
    Send the card number, PIN, and order amount to the Devalue endpoint
  4. We handle everything
    Festivalcadeau validates the card, checks the balance, and deducts the amount via Intersolve
  5. Receive payout
    Festivalcadeau sends you an invoice (minus commission) and pays you out

Advantages

Works Worldwide

No per-country payment gateway integration needed. Works in any country.

No PSP Required

Call our API directly from your backend. No Mollie, pay.nl or any other PSP needed.

Simple API

Card number + PIN = one API call. We handle validation, balance checks, and deduction.

Built-in Refunds

One-time cancel tokens for easy refunds if a customer doesn't complete their purchase.

Integration Steps

Step Action Who
1 Authenticate and obtain your API key Ticket seller
2 Build a "Pay with Festivalcadeau" UI in your checkout Ticket seller
3 Devalue the card with the order amount Ticket seller → Festivalcadeau API
4 Handle partial payments if remaining_to_pay > 0 Ticket seller
5 Receive invoice and payout Festivalcadeau → Ticket seller

Available API Endpoints

Endpoint Method Description Docs
/api/endpoint/v1/devalue POST Deduct value from a giftcard View docs →
/api/endpoint/v1/balance POST Check card balance before deducting View docs →
/api/endpoint/v1/canceldevalue POST Reverse a devalue and reload the card View docs →
Getting started: Register an account to receive your apikey and company_id automatically, or contact us at info@festivalcadeau.com.
Using Mollie or pay.nl? If you're a Dutch partner using one of the supported PSPs, you may not need this API integration. Check With PSP (Netherlands) instead.