Greiðslutenglar

Greiðslutenglar eru endurnýtanleg URL sem gera viðskiptavinum kleift að greiða fyrir pöntun. Ólíkt stöðluðum pöntunum sem renna út eftir eina misheppnaða tilraun styðja greiðslutenglar margar endurtilraunir, sem gerir þá fullkomna fyrir reikninga, greiðslur með tölvupósti og aðstæður þar sem viðskiptavinurinn greiðir ekki strax.

Lykileiginleikar

Endurnýtanlegir: Viðskiptavinir geta reynt greiðslu allt að 25 sinnum ef fyrri tilraunir mistakast.
Langlífir: Sjálfgefinn gildistími er 30 dagar (stillanlegur með expiration_period).
Deilanlegir: Sendu tengilinn með tölvupósti, SMS, spjalli eða felldu hann inn á vefsíðuna þína.

Stofnun greiðslutengils

Sendu POST-beiðni á /v1/paymentlinks/:

POST /v1/paymentlinks/

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": 995,
    "currency": "EUR",
    "description": "Invoice #1234"
  }'

Svarið inniheldur payment_url til að deila með viðskiptavininum og einstakt id til rakningar:

Svar (201 Created)

{
  "id": "e6eecc6a-47c5-4948-bcc0-d8b73f5c55a1",
  "merchant_order_id": "invoice-1234",
  "amount": 995,
  "currency": "EUR",
  "description": "Invoice #1234",
  "expiration_period": "P30D",
  "payment_url": "https://pay.costplus.online/paymentlinks/e6eecc6a.../",
  "status": "new",
  "reason": "Payment Link was created, not yet visited",
  "orders": {},
  "created": "2026-01-15T12:00:00.000000Z"
}

Vistaðu id — þú munt nota það til að athuga stöðu greiðslutengils síðar.

Nauðsynlegir reitir

Reitur	Lýsing
`merchant_order_id`	Eigin tilvísunarnúmer þitt fyrir greiðslutengilinn
`amount`	Upphæð í sentum (t.d. 9,95 EUR = `995`)
`currency`	ISO 4217 gjaldmiðilskóði (t.d. `EUR`, `GBP`)

Valfrjálsir reitir

Reitur	Lýsing
`description`	Lýsing sýnd viðskiptavininum
`expiration_period`	ISO 8601 tímalengd. Sjálfgefið er `P30D` (30 dagar)
`return_url`	URL til að endurbeina viðskiptavininum eftir vel heppnaða greiðslu
`failure_url`	URL til að endurbeina viðskiptavininum við afturköllun, útrunninn eða villu
`webhook_url`	URL til að fá tilkynningar um stöðubreytingar
`customer`	Hlutur viðskiptavinaupplýsinga (nafn, tölvupóstur o.fl.)

Ef þú gefur upp bæði return_url og failure_url, er viðskiptavinum vísað á failure_url þegar staða pöntunar er cancelled, expired eða error. Annars fara allar endurbeiningar á return_url.

Sækja greiðslutengil

Sendu GET-beiðni á /v1/paymentlinks/{id}/ með id greiðslutengils úr stofnunarsvarinu:

GET /v1/paymentlinks/{id}/

curl -u YOUR_API_KEY: \
  https://api.costplus.online/v1/paymentlinks/e6eecc6a-47c5-4948-bcc0-d8b73f5c55a1/

Svarið inniheldur núverandi stöðu og tilvísanir í allar pantanir stofnaðar frá tenglinum, flokkaðar eftir stöðu:

Svar (lokin dæmi)

{
  "id": "e6eecc6a-47c5-4948-bcc0-d8b73f5c55a1",
  "merchant_order_id": "invoice-1234",
  "amount": 995,
  "currency": "EUR",
  "description": "Invoice #1234",
  "expiration_period": "P30D",
  "payment_url": "https://pay.costplus.online/paymentlinks/e6eecc6a.../",
  "status": "completed",
  "reason": "Completed",
  "completed": "2026-01-15T12:05:30.123456+00:00",
  "completed_order_id": "3bb663cc-2a20-400d-8bf6-18d9695d0c66",
  "orders": {
    "error": ["0d79014c-0aaa-4fd6-87c5-c8cfa5f5ac69"],
    "completed": ["3bb663cc-2a20-400d-8bf6-18d9695d0c66"]
  }
}

Stöður greiðslutengla

Staða	Lýsing
`new`	Tengillinn hefur verið stofnaður en engin greiðslutilraun hefur enn verið gerð.
`processing`	Greiðslutilraun er í gangi.
`all_unsuccessful`	Allar greiðslutilraunir hafa hingað til mistekist. Viðskiptavinurinn getur enn reynt aftur (allt að 25 tilraunir).
`completed`	Greiðsla tókst. Tengillinn er ekki lengur virkur.
`expired`	Tengillinn rann út áður en vel heppnuð greiðsla átti sér stað.

Staðan all_unsuccessful er ekki lokastaða. Viðskiptavinurinn getur enn reynt að greiða þar til greiðsla tekst, hámarksfjöldi tilrauna (25) er náð eða tengillinn rennur út.

Þegar greiðslutengill nær stöðunni completed eða expired er ekki hægt að nota hann aftur. Stofnaðu nýjan greiðslutengil ef viðskiptavinurinn þarf að greiða aftur.

Dæmi um verkflæði

Stofnaðu greiðslutengil gegnum POST /v1/paymentlinks/.
Deildu payment_url sem skilað var með viðskiptavininum (t.d. með tölvupósti, SMS eða reikningi).
Viðskiptavinurinn opnar tengilinn og lýkur greiðslu.
Cost+ sendir webhook á webhook_url þitt þegar staðan breytist.
Staðfestu stöðu greiðslutengils gegnum GET /v1/paymentlinks/{id}/.
Uppfylltu pöntunina þegar staðan er completed.

Tengdir endapunktar

Stofna greiðslutengil — stofnaðu endurnýtanlegan greiðslutengil
Sækja greiðslutengil — sæktu núverandi stöðu greiðslutengils

On this page