Snelstart

Deze handleiding begeleidt u bij het aanmaken en voltooien van een testbetaling met de Cost+ API. Aan het einde heeft u een werkende integratie waarop u kunt voortbouwen.

Vereisten

• Een Cost+ account met een sandbox-website — maak er een aan in het handelaarsportaal
• Uw sandbox API-sleutel (te vinden onder Websites → uw sandbox-website → Integration)

Stap 1: Een bestelling aanmaken

Stuur een POST-verzoek om een betalingsbestelling aan te maken. Vervang YOUR_API_KEY door uw sandbox API-sleutel:

curl -X POST https://api.costplus.online/v1/orders/ \
  -u YOUR_API_KEY: \
  -H "Content-Type: application/json" \
  -d '{
    "currency": "EUR",
    "amount": 1295,
    "merchant_order_id": "my-first-order",
    "description": "Test order",
    "return_url": "https://example.com/return",
    "webhook_url": "https://example.com/webhook",
    "transactions": [
      {
        "payment_method": "credit-card"
      }
    ]
  }'

De API retourneert het volledige bestellingsobject. De belangrijkste velden zijn id, status en de payment_url in de transactie:

{
  "id": "4851e31c-4137-4e91-95ef-1df945ee76a2",
  "status": "new",
  "currency": "EUR",
  "amount": 1295,
  "merchant_order_id": "my-first-order",
  "description": "Test order",
  "return_url": "https://example.com/return",
  "webhook_url": "https://example.com/webhook",
  "created": "2026-01-15T12:00:05.433502+00:00",
  "modified": "2026-01-15T12:00:05.553125+00:00",
  "expiration_period": "PT1H",
  "transactions": [
    {
      "id": "d291f03f-a406-428a-967a-4895a46e03fd",
      "payment_method": "credit-card",
      "status": "new",
      "amount": 1295,
      "currency": "EUR",
      "payment_url": "https://pay.costplus.online/4851e31c.../credit-card/d291f03f...",
      "is_capturable": false,
      "expiration_period": "PT30M"
    }
  ]
}

Sla het id op — u heeft dit nodig in Stap 3.

Stap 2: De testbetaling voltooien

1. Open de payment_url uit de respons in uw browser
2. Voer op de betaalpagina de testkaartgegevens in:

3. Verzend de betaling
4. U wordt teruggeleid naar uw return_url

Stap 3: De betaling verifieren

Haal de bestelling op om te bevestigen dat deze is voltooid:

curl -u YOUR_API_KEY: \
  https://api.costplus.online/v1/orders/4851e31c-4137-4e91-95ef-1df945ee76a2/

Een geslaagde betaling ziet er als volgt uit:

{
  "id": "4851e31c-4137-4e91-95ef-1df945ee76a2",
  "status": "completed",
  "currency": "EUR",
  "amount": 1295,
  "merchant_order_id": "my-first-order",
  "completed": "2026-01-15T12:02:30.123456+00:00",
  "transactions": [
    {
      "id": "d291f03f-a406-428a-967a-4895a46e03fd",
      "payment_method": "credit-card",
      "status": "completed",
      "amount": 1295,
      "currency": "EUR",
      "payment_method_details": {
        "truncated_pan": "1111",
        "card_expiry": "122028"
      }
    }
  ]
}

De bestelling status is "completed" — de betaling is geslaagd.

Stap 4: De webhook afhandelen (aanbevolen)

Wanneer de betalingsstatus verandert, stuurt Cost+ een POST-verzoek naar uw webhook_url:

{
  "event": "status_changed",
  "order_id": "4851e31c-4137-4e91-95ef-1df945ee76a2"
}

Wanneer u dit ontvangt:

1. Roep GET /v1/orders/{order_id}/ aan om de huidige status te verifieren (vertrouw nooit alleen op de webhook-payload)
2. Retourneer HTTP 200 om de ontvangst te bevestigen
3. Verwerk de bestelling als de status "completed" is

Zie de Webhooks-handleiding voor herhaalpogingen, best practices en payloaddetails.

Alternatief: Betaallinks

Als u geen server-side doorverwijzingslogica nodig heeft, bieden betaallinks een eenvoudiger pad. Maak een link aan, deel de URL met uw klant en controleer de status later.

curl -X POST https://api.costplus.online/v1/paymentlinks/ \
  -u YOUR_API_KEY: \
  -H "Content-Type: application/json" \
  -d '{
    "merchant_order_id": "invoice-1234",
    "amount": 2500,
    "currency": "EUR",
    "description": "Invoice #1234"
  }'

De respons bevat een payment_url die u kunt delen via e-mail, sms of chat. De klant kan meerdere keren betalen (tot 25 keer) totdat de link verloopt of de betaling slaagt.

Zie de Betaallinks-handleiding voor de volledige workflow.

Wat nu?

U heeft uw eerste betaling voltooid. Hier kunt u verder gaan:

• Hosted Payment Page — volledige HPP-referentie met alle verzoeksvelden en opties
• Terugkerende betalingen — abonnementen en geplande facturering instellen
• One-Click betalingen — snel afrekenen voor terugkerende klanten
• Autorisatie / Capture / Void — eerst autoriseren, later vastleggen (bijv. bij verzending)
• Terugbetalingen — volledige en gedeeltelijke terugbetalingen verwerken
• SDK's — officiele bibliotheken voor Node.js, Python, PHP, Java/Kotlin, C#/.NET en Ruby
• Plugins — kant-en-klare integraties voor Shopify, WooCommerce, Magento en meer

Gerelateerde eindpunten

• Bestelling aanmaken — volledige API-referentie voor het aanmaken van bestellingen
• Bestelling ophalen — bestellingsgegevens en status ophalen
• Betaallink aanmaken — herbruikbare betaallinks aanmaken