Payment Flow

Accept Festivalcadeau giftcard payments at your checkout, both for domestic (NL) and international partners.

Flow Diagram

Festivalcadeau Giftcard Payment Flow

Domestic Flow (Netherlands)

In the Netherlands, the Festivalcadeau giftcard is integrated with payment gateways like Mollie and pay.nl.

  1. Customer has a Festivalcadeau giftcard
  2. During ticket checkout, the customer selects "Festivalcadeau" as payment method
  3. The payment gateway (Mollie / pay.nl) communicates with Intersolve to activate and devalue the card
  4. Festivalcadeau receives the card value
Limitation: This flow requires a payment gateway integration per country, which makes it not scalable internationally.

International Flow

For international partners, we offer a direct API integration that requires no payment gateway. This works worldwide.

How it Works

  1. Build a payment option
    Add a "Pay with Festivalcadeau" button 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 and deducts the amount via Intersolve
  5. Receive payout
    Festivalcadeau sends you an invoice (minus commission) and pays you out

Why This Works Internationally

  • No payment gateway required: call our API directly
  • Works in any country: no per-country integration needed
  • Card number + PIN = single API call
  • Ticket seller is paid via invoice

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 Receive invoice and payout Festivalcadeau → Ticket seller

Available API Endpoints

Endpoint Method Description
/api/endpoint/v1/devalue POST Deduct value from a giftcard
/api/endpoint/v1/balance POST Check card balance before deducting
/api/endpoint/v1/cancelorder POST Cancel/refund a card activation
/api/endpoint/v1/canceldevalue POST Reverse a devalue and reload the card (one-time token)