Gyorsindítás

Ez az útmutató végigvezeti Önt egy tesztfizetés létrehozásán és befejezésén a Cost+ API segítségével. A végére egy működő integrációval rendelkezik, amelyre építhet.

Előfeltételek

Cost+ fiók egy sandbox weboldallal — hozzon létre egyet a kereskedői portálban
Az Ön sandbox API-kulcsa (a Weboldalak → az Ön sandbox weboldala → Integráció menüpont alatt található)

Nem tudja, hogyan szerezheti meg az API-kulcsát? Tekintse meg az Integráció tesztelése oldalt a részletes beállítási útmutatóért.

1. lépés: Rendelés létrehozása

Küldjön egy POST kérést egy fizetési rendelés létrehozásához. Cserélje le a YOUR_API_KEY értéket az Ön sandbox API-kulcsára:

Create an order

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"
      }
    ]
  }'

Az amount a legkisebb pénznem-egységben van megadva (cent). A 1295 érték 12,95 EUR-t jelent.

Az API a teljes rendelés objektumot adja vissza. A legfontosabb mezők az id, a status és a tranzakción belüli payment_url:

Response

{
  "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"
    }
  ]
}

Mentse el az id értéket — a 3. lépésben szüksége lesz rá.

2. lépés: A tesztfizetés befejezése

Nyissa meg a válaszban kapott payment_url-t a böngészőjében
A fizetési oldalon adja meg a tesztkártya adatait:

Mező	Érték
Kártyaszám	`4111 1111 1111 1111`
Lejárat	Bármely jövőbeli dátum (pl. `12/28`)
CVC	Bármely 3 számjegy (pl. `123`)

Küldje el a fizetést
Visszairányítjuk az Ön return_url címére

Ne hagyatkozzon kizárólag az átirányításra a fizetés megerősítéséhez. Az ügyfél bezárhatja a böngészőjét, mielőtt átirányítanák. Mindig ellenőrizze az API-n (3. lépés) vagy webhookon (4. lépés) keresztül.

3. lépés: A fizetés ellenőrzése

Kérje le a rendelést, hogy meggyőződjön a teljesítésről:

Check order status

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

Egy sikeres fizetés így néz ki:

Response (completed)

{
  "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"
      }
    }
  ]
}

A rendelés status értéke "completed" — a fizetés sikeres volt.

4. lépés: Webhook kezelése (ajánlott)

Amikor a fizetés állapota megváltozik, a Cost+ POST kérést küld az Ön webhook_url címére:

Webhook payload

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

Amikor megkapja:

Hívja meg a GET /v1/orders/{order_id}/ végpontot az aktuális állapot ellenőrzéséhez (soha ne bízzon kizárólag a webhook adatcsomagban)
Válaszoljon HTTP 200 kóddal a fogadás nyugtázásához
Teljesítse a rendelést, ha az állapot "completed"

Helyi fejlesztéshez használjon tunnelt, például az ngrok-ot, hogy elérhetővé tegye a helyi szerverét és fogadni tudja a webhookokat.

A webhook újrapróbálkozási logikáról, bevált gyakorlatokról és az adatcsomag részleteiről lásd a Webhookok útmutatót.

Alternatíva: Fizetési linkek

Ha nincs szüksége szerveroldali átirányítási logikára, a fizetési linkek egyszerűbb utat kínálnak. Hozzon létre egy linket, ossza meg az URL-t az ügyfelével, és ellenőrizze az állapotot később.

Create a payment link

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"
  }'

A válasz tartalmaz egy payment_url-t, amelyet e-mailben, SMS-ben vagy chaten oszthat meg. Az ügyfél többször is megkísérelheti a fizetést (legfeljebb 25 alkalommal), amíg a link le nem jár vagy a fizetés sikeres nem lesz.

A teljes munkafolyamatért lásd a Fizetési linkek útmutatót.

Mi a következő lépés?

Teljesítette az első fizetését. Íme, merre tovább:

Tárolt fizetési oldal — teljes HPP referencia az összes kérési mezővel és opcióval
Ismétlődő fizetések — előfizetések és ütemezett számlázás beállítása
Egykattintásos fizetés — gyors fizetés visszatérő ügyfeleknek
Engedélyezés / Rögzítés / Érvénytelenítés — először engedélyezés, később rögzítés (pl. szállításkor)
Visszatérítések — teljes és részleges visszatérítések feldolgozása
SDK-k — hivatalos könyvtárak Node.js, Python, PHP, Java/Kotlin, C#/.NET és Ruby nyelvekhez
Bővítmények — előre elkészített integrációk Shopify, WooCommerce, Magento és más platformokhoz

Kapcsolódó végpontok

Rendelés létrehozása — teljes API-referencia a rendelés létrehozásához
Rendelés lekérdezése — rendelés részleteinek és állapotának lekérdezése
Fizetési link létrehozása — újrafelhasználható fizetési linkek létrehozása

On this page