Hoe plaats je je eerste Peecho print API bestelling

De Peecho print API gebruiken om een bestelling te plaatsen

Het proces begint wanneer je klant een aankoop afrondt op je app of platform. U int de betaling via uw eigen kassasysteem. Door de Peecho print API te integreren in je orderflow, automatiseer je het aanmaken van bestellingen, de betaling en de verzending naar de productie.

Met de API kun je ook offertes aanvragen, bestelgegevens bijwerken, statussen volgen en nog veel meer.

De gehoste kassa van Peecho gebruiken om een bestelling te plaatsen

Om Peecho's gehoste kassa te gebruiken, begin je met het maken van een productvermelding in je dashboard. Dit genereert een afrekenlink, die je direct met klanten kunt delen of op je website kunt insluiten als een knop 'Afdrukken kopen'.

Volg deze stappen om een bestelling te plaatsen via onze API v3:

1. Verkrijg je API-sleutel en voeg accountgegevens toe
2. Kies een product
3. Een bestand maken
4. Een bestelling maken
5. Betaling indienen

We zullen al deze stappen doorlopen aan de hand van een hardcover boek als voorbeeld.

1. Ontvang uw API-sleutel en voeg accountgegevens toe

Maak eerst een account aan in de testomgeving om je API credentials te verkrijgen. Je kunt je API-sleutel vinden in het testdashboard onder Instellingen > API.

Houd er rekening mee dat productIds en apiKeys van de productieomgeving niet werken in de testomgeving, en omgekeerd.

Voordat je een bestelling plaatst, moet je je bedrijfsadres invoeren. Dit is belangrijk omdat de belasting die op elke bestelling wordt geheven, deels is gebaseerd op de locatie van je bedrijf.

Om te testen kun je schijngegevens gebruiken. Om je gegevens toe te voegen, ga je naar Dashboard > Instellingen > API > Bedrijfsgegevens.

2. Kies een product

Voor dit voorbeeld gebruiken we een van onze populairste producten: een A4 liggend hardcover boek (21 x 29,7 cm).

Elke account heeft een unieke set product-ID's. Om die van u te vinden, gaat u naar Dashboard > Instellingen > Producten > Boeken > Product-ID.

Als je de API met een ander product wilt testen, kun je dat op dezelfde pagina vinden en selecteren. Zorg ervoor dat je een bestand hebt dat voldoet aan de specificaties van het product.

3. Maak een bestand

Elk product vereist een specifieke bestandsindeling. De meeste producten bevelen een resolutie van 300 DPI aan en moeten worden ingediend in het RGB-kleurenprofiel. Ga voor gedetailleerde bestandsrichtlijnen naar het Peecho Helpcentrum.

Voor dit voorbeeld gebruiken we het A4 liggend fotoboek, dat 21 x 29,7 cm meet. Dit product vereist minimaal 24 pagina's, dus je bestand moet minimaal die lengte hebben.

De Peecho API accepteert twee bestandsindelingen voor boeken:

a) Cover en inhoud in hetzelfde bestand

Maak één PDF met de vooromslag, inhoudspagina's en achteromslag, gerangschikt als afzonderlijke pagina's in die volgorde. De eerste pagina wordt afgedrukt als vooromslag en de laatste als achteromslag. De rug is standaard leeg gelaten.

Als je een ruggengraat wilt opnemen, zijn er twee opties:

1. Dynamische ruggengraat - Automatisch gegenereerd door Peecho, gebaseerd op de productafmetingen en het dynamic_spine_details object in uw create new order api call
   ‍
2. Aangepaste rug - Door u aangeleverd via een aangepaste PDF URL gekoppeld in het spine_details object. Gebruik het Get spine width eindpunt om de juiste rugdikte te berekenen. De rug PDF zelf moet precies de breedte hebben die het endpoint teruggeeft, en de hoogte moet overeenkomen met de hoogte van het boek.

b) Cover en inhoud als aparte bestanden

In deze opstelling lever je twee bestanden:

• Eén voor de omslag (inclusief voorkant, rug en achterkant als één spread)
• Eén voor de binnenpagina's (alleen inhoud)

Deze aanpak is ideaal voor omslagontwerpen. Als je deze opzet gebruikt, moet je de rugdikte handmatig berekenen met het eindpunt Rugdikte ophalen.

Als u geen bestand hebt om mee te testen, kunt u het Peecho-voorbeeldbestand gebruiken, dat zowel de omslag als de inhoud bevat. Als u een aangepaste rug wilt testen met het voorbeeldbestand, kunt u het aangepaste rug PDF-bestand gebruiken.

4. Een bestelling aanmaken

Nu je een product hebt geselecteerd en je bestand hebt voorbereid, kun je de bestelling maken door een POST-verzoek te sturen naar:
https://test.www.peecho.com/rest/v3/orders/

Het aanmaken van een bestelling vereist een enkele API-aanroep, inclusief alle relevante gegevens. Zorg ervoor dat u de MerchantKey en productId van uw testaccount gebruikt - productiegegevens werken niet in de testomgeving.

Je kunt op twee manieren een bestelling aanmaken:

a) Neem het bestand op bij het maken van de bestelling

Geef de bestands-URL op in het object file_details.

b) Voeg het bestand toe na betaling

Laat de file_details parameters leeg tijdens het aanmaken van de order. Je levert de bestanden later aan met het eindpunt Bestanden asynchroon instellen .

Zodra de order is aangemaakt, verschijnt deze op je dashboard in de status Open. Je hebt de orderId nodig om een betaling te doen en de order naar productie te sturen als onderdeel van de orderstroom.

Voor dit voorbeeld maken we een order aan met twee items - één met een dynamische rug en één met een aangepaste URL voor de rug. De gegevens moeten het formaat van het Order object volgen:

{
  "merchant_api_key": "YourAPIKeyHere:ABCD1234XXXX",
  "purchase_order": "",
  "currency": "EUR",
  "item_details":
  [
    {
      "item_reference": "hardcover_22",
      "offering_id": "YourOfferingIDHere",
      "quantity": 3,
      "file_details":
      {
        "content_url": "https://peecho-thumbnailer.s3.eu-west-1.amazonaws.com/Peecho+HCB+print+file.pdf",
        "content_width": 210,
        "content_height": 29.7,
        "number_of_pages": 80,
        "spine_details":
        {
          "dynamic_spine_details":
          {
            "text_font": "Arial",
            "text_size": 10,
            "text_colour": "#77493f",
            "text_top": "top text",
            "text_center": "center text",
            "text_bottom": "bottom text"
          }
        }
      }
    },
    {
      "item_reference": "hardcover_23",
      "offering_id": 233309,
      "quantity": 2,
      "file_details":
      {
        "content_url": "https://peecho-thumbnailer.s3.eu-west-1.amazonaws.com/Peecho+HCB+print+file.pdf",
        "content_width": 210,
        "content_height": 29.7,
        "number_of_pages": 80,
        "spine_details":
        {
          "custom_spine_url": "https://peecho-thumbnailer.s3.eu-west-1.amazonaws.com/Custom%20spine%20PDF.pdf"
        }
      }
    }
  ],
  "address_details":
  {
    "email_address": "joshua@designy.com",
    "shipping_address":
    {
      "first_name": "Joshua",
      "last_name": "Grim",
      "address_line_1": "Test",
      "address_line_2": 1,
      "zip_code": "35100",
      "city": "Florida",
      "state": null,
      "country_code": "ARE"
    }
  }
}

‍

5. Betaling indienen

Om te betalen voor een print API bestelling, stuur je een verzoek naar het Payment endpoint. Voordat je dit kunt doen, moet je credits kopen in de testomgeving. Deze credits worden gebruikt om te betalen voor de bestellingen die je aanmaakt.

Om credits te kopen, ga je naar Dashboard > Instellingen > API > Credit > Credit kopen. In de testomgeving kunt u schijnbetaalmethoden gebruiken, zoals Stripe testkaarten.

Zodra u credits hebt verworven, roept u het eindpunt Betaling aan om te bevestigen dat de bestelling is afgerond en klaar is voor productie. Dit simuleert een scenario waarin uw klant u al rechtstreeks heeft betaald.

Om de betaling in te dienen, heb je het volgende nodig:

• orderId
• Test merchant_api_key
• geheim (SHA-256 gecodeerd)

De Peecho API bevat ook eindpunten voor besteloffertes, productinformatie en bestelstatus.

Ga voor meer informatie naar onze API-documentatie. Als je hulp nodig hebt bij het testen of implementeren van API v3, helpen we je graag - neem contact met ons op via support@peecho.com.