FlipLink

Een flipbook verkopen en verkopen inzien

Leads en verkopen

Maak van een flipbook een betaald product — stel de prijs, checkouttekst en betaalgateway in, registreer aankopen, en lees je verkooprecords via de API.

API's die in deze discussie worden gebruikt

Iets onjuist of verouderd in deze gids?

Wat je kunt doen

Deze vijf endpoints dekken de volledige levenscyclus van het verkopen van een flipbook en het volgen van wat hij oplevert:

  • Configureer de verkoop — stel prijs, valuta en of de flipbook te koop is in.
  • Pas de checkoutpagina aan — titels, knoptekst en knopkleur.
  • Kies een betaalgateway — kies de gateway en stel de bijbehorende gegevens in.
  • Registreer een aankoop — leg een voltooide verkoop vast die via je eigen betaalflow is gedaan.
  • Lees je verkopen — bekijk voltooide (of verlaten-winkelwagen)verkooprecords, met paginering en CSV-export.

Voordat je begint

  • Een API-sleutel — meegestuurd als de X-Api-Key-header, of als Authorization: Bearer YOUR_API_KEY, op elk verzoek.
  • Alle verzoeken gaan naar de basis-URL https://go.fliplink.me.
  • Elk endpoint behalve List Sales neemt de numerieke ID van de flipbook als {flipbookId}-padparameter — bijvoorbeeld .../set-sale-settings/96216.
  • De schrijf-endpoints (Set Sale Settings, Set Sale Page Text, Set Sale Gateway, Set Flipbook Purchase) sturen hun body als form-urlencoded velden (GEEN JSON).

De verkoop configureren

PUT /api/set-sale-settings/{flipbookId} configureert het verkopen van de flipbook (prijs, valuta, opties). Het inschakelen van de verkoopmodus zet automatisch e-mailverificatie aan en maakt de lead-e-mail verplicht.

Belangrijke velden:

  • SaleAmount — de prijs in hele valuta-eenheden (bijv. dollars), decimalen toegestaan. 9.99 betekent $9,99 en 1000 betekent $1.000 — dit is GEEN waarde in centen/kleinere eenheden.
  • SaleCurr — de valutacode (standaard usd). Kies een geldige code uit /api/list-currencies.
curl -X PUT 'https://go.fliplink.me/api/set-sale-settings/96216' \
  -H 'X-Api-Key: YOUR_API_KEY' \
  --data-urlencode 'IsForSale=true' \
  --data-urlencode 'SaleCurr=usd' \
  --data-urlencode 'SaleAmount=9.99'

Response:

{
  "Result": "OK",
  "Message": "Updated successfully"
}

De checkoutpagina aanpassen

PUT /api/set-sale-page-text/{flipbookId} stelt de marketingtekst in die op de verkoop-/checkoutpagina van de flipbook wordt getoond.

curl -X PUT 'https://go.fliplink.me/api/set-sale-page-text/96216' \
  -H 'X-Api-Key: YOUR_API_KEY' \
  --data-urlencode 'SalePageTitle=' \
  --data-urlencode 'SaleAccessPageTitle=' \
  --data-urlencode 'SalePurchaseButtonText=' \
  --data-urlencode 'SaleButtonText=' \
  --data-urlencode 'SaleAccessButtonText=' \
  --data-urlencode 'SaleButtonColor='

Response:

{
  "Result": "OK",
  "Message": "Updated successfully"
}

Een betaalgateway kiezen

PUT /api/set-sale-gateway/{flipbookId} selecteert en configureert de betaalgateway die bij de verkoop van deze flipbook wordt gebruikt.

curl -X PUT 'https://go.fliplink.me/api/set-sale-gateway/96216' \
  -H 'X-Api-Key: YOUR_API_KEY' \
  --data-urlencode 'SaleGatewayName=' \
  --data-urlencode 'SaleGatewayKey=' \
  --data-urlencode 'SaleGatewaySecret='

Response:

{
  "Result": "OK",
  "Message": "Updated successfully"
}

Een aankoop registreren

POST /api/set-flipbook-purchase/{flipbookId} registreert een voltooide flipbookverkoop (aankoop) — gebruik het om aankopen vast te leggen die via je eigen betaalflow zijn gedaan, zonder de Stripe-checkout van FlipLink. Stuur de Email van de koper en je betaalgateway-referentie PaymentRef mee (voor Stripe de PaymentIntent-ID, pi_...); beide zijn verplicht. Stuur GEEN Amount/Currency mee — die worden server-side afgeleid uit je betaalreferentie.

curl -X POST 'https://go.fliplink.me/api/set-flipbook-purchase/96216' \
  -H 'X-Api-Key: YOUR_API_KEY' \
  --data-urlencode 'Email=customer@example.com' \
  --data-urlencode 'PaymentRef=pi_3O1234567890abcdef'

Response:

{
  "Result": "OK",
  "Message": "Purchase recorded successfully"
}

Je verkopen lezen

GET /api/list-sales somt verkoop-/aankooprecords voor je flipbooks op (koperse-mail, flipbook, bedrag, datum) plus de kolomdefinities voor de verkooptabel. Het ondersteunt paginering en CSV-export via IsDownload. Zet IsAbandoned=true om verlaten-winkelwagenverkopen terug te geven in plaats van voltooide verkopen.

curl -X GET 'https://go.fliplink.me/api/list-sales?ItemIDs=&SearchText=&PageNo=1&Offset=0&IsDownload=true&IsAbandoned=false' \
  -H 'X-Api-Key: YOUR_API_KEY'

Response:

{
  "Result": "OK",
  "Items": [],
  "Columns": [
    {
      "ID": 1,
      "data": "ID",
      "title": "ID",
      "type": "numeric",
      "hidden": true,
      "readOnly": true,
      "defaultValue": "",
      "source": "",
      "width": 0,
      "backgroundColor": "",
      "align": "left"
    }
  ],
  "TotalRecordCount": 0
}

Mogelijke fouten

  • Ontbrekende of ongeldige API-sleutel → HTTP 401. Dit geeft een kale Unauthorized-HTML-pagina terug — er is geen JSON-body. Controleer of de X-Api-Key-header aanwezig en correct is.
  • Onbekende flipbookId (of een die niet bij je sleutel hoort) → HTTP 200 met { "Result": "ERROR", "Message": "Item not found" }. Dit geldt voor Set Sale Settings, Set Sale Page Text, Set Sale Gateway en Set Flipbook Purchase.
  • Onbekend of verkeerd gespeld body-veld → HTTP 200 met { "Result": "ERROR", "Message": "Unknown field(s) '…'. Expected: …" }.
  • Ontbrekend verplicht aankoopveld (Set Flipbook Purchase) → { "Result": "ERROR", "Message": "Email is required." } of { "Result": "ERROR", "Message": "PaymentRef is required." }.

Opmerkingen

  • Het inschakelen van de verkoopmodus (IsForSale) via Set Sale Settings zet automatisch e-mailverificatie aan en maakt de lead-e-mail verplicht.
  • Set Flipbook Purchase is voor aankopen die via je eigen betaalflow zijn gedaan — het laat je een verkoop vastleggen zonder de Stripe-checkout van FlipLink.

Gerelateerde discussies

Leads ophalen en verwijderen