Hýst greiðslusíða (HPP)

Hýsta greiðslusíðan (HPP) er PCI DSS-samhæft greiðsluform Cost+. Hún gerir þér kleift að taka á móti greiðslum án þess að meðhöndla viðkvæm kortagögn á eigin þjónum. Þú stofnar pöntun gegnum API, endurbeinir viðskiptavininn á hýstu síðuna og hann snýr aftur á vefsíðuna þína eftir greiðslu.

Hvernig það virkar

Þjónninn þinn stofnar pöntun með kalli á POST /v1/orders/.
API skilar URL sem vísar á hýstu greiðslusíðuna.
Þú endurbeinir viðskiptavininum á greiðslusíðuna.
Viðskiptavinurinn lýkur greiðslu á hýstu síðu Cost+.
Viðskiptavininum er vísað aftur á return_url þitt (eða failure_url fyrir misheppnaðar greiðslur).
Cost+ sendir webhook-tilkynningu á webhook_url þitt með stöðu pöntunar.

Hýsta greiðslusíðan er að fullu PCI DSS-samhæf. Þú þarft aldrei að meðhöndla hráar kortanúmer eða viðkvæm greiðslugögn á þjónunum þínum.

Stofnun pöntunar

Tvær leiðir eru til að nota HPP:

Leið 1: Sýndu alla greiðslumáta (einfaldast)

Stofnaðu pöntun án þess að tilgreina transactions. Svarið inniheldur order_url — viðskiptavininum er vísað þangað og sér alla greiðslumáta sem eru virkir fyrir reikninginn þinn:

Beiðni

{
  "currency": "EUR",
  "amount": 1295,
  "merchant_order_id": "my-order-id-1",
  "description": "My amazing order",
  "return_url": "https://www.example.com",
  "webhook_url": "https://www.example.com/webhook"
}

Svar

{
  "id": "43114fde-da30-4115-8004-b7f808f9b25c",
  "status": "new",
  "currency": "EUR",
  "amount": 1295,
  "order_url": "https://pay.costplus.online/43114fde.../select-payment-method/",
  "return_url": "https://www.example.com",
  "webhook_url": "https://www.example.com/webhook"
}

Endurbeindu viðskiptavininum á order_url. Á hýstu síðunni eru allir virkir greiðslumátar sýndir.

Leið 2: Forveldu greiðslumáta

Stofnaðu pöntun með transactions fylki til að stjórna hvaða greiðslumátar birtast og í hvaða röð. Hver færsla inniheldur payment_method og svarið skilar payment_url innan færsluhlutarins:

Beiðni

{
  "currency": "EUR",
  "amount": 1295,
  "merchant_order_id": "my-order-id-1",
  "description": "My amazing order",
  "return_url": "https://www.example.com",
  "webhook_url": "https://www.example.com/webhook",
  "transactions": [
    { "payment_method": "credit-card" }
  ]
}

Svar

{
  "id": "4851e31c-4137-4e91-95ef-1df945ee76a2",
  "status": "new",
  "currency": "EUR",
  "amount": 1295,
  "transactions": [
    {
      "id": "d291f03f-a406-428a-967a-4895a46e03fd",
      "payment_method": "credit-card",
      "status": "new",
      "payment_url": "https://pay.costplus.online/4851e31c.../credit-card/d291f03f.../"
    }
  ]
}

Endurbeindu viðskiptavininum á payment_url úr færslunni.

Ef þú gefur aðeins einn reit í transactions fylkinu er viðskiptavininum beint á þann greiðslumáta án vals. flags fylkið inniheldur "is-test" þegar sandbox API lykill er notaður.

Reitir beiðni

Reitur	Nauðsynlegur	Lýsing
`currency`	Já	ISO 4217 gjaldmiðilskóði (t.d. `EUR`, `GBP`, `SEK`)
`amount`	Já	Upphæð í sentum. Til dæmis er 12,95 EUR sýnt sem `1295`
`merchant_order_id`	Nei	Eigin tilvísunarnúmer þitt fyrir pöntunina
`return_url`	Nei	URL til að endurbeina viðskiptavininum eftir greiðslu (sjálfgefið fyrir allar stöður)
`failure_url`	Nei	URL til að endurbeina viðskiptavininum við stöðuna `cancelled`, `expired` eða `error` (sjá skilavefslóðir hér að neðan)
`locale`	Nei	Tungumál greiðslusíðunnar. Stutt: `en-GB`, `de-DE`, `nl-NL`, `nl-BE`, `fr-BE`, `sv-SE`, `no-NO`, `da-DK`
`description`	Nei	Lýsing á pöntuninni, sýnd viðskiptavininum
`payment_methods`	Nei	Filter to a single payment method (e.g. `["credit-card"]`). Omit to show all enabled methods. For multiple specific methods, use the `transactions` array instead
`webhook_url`	Nei	URL til að fá tilkynningar um stöðubreytingar
`expiration_period`	Nei	ISO 8601 tímalengd fyrir útrunnin pöntun. Sjálfgefið er `PT30M` (30 mínútur)

amount reiturinn er alltaf í minnstu gjaldmiðilseiningu (sentum). Sending 1295 þýðir 12,95 í gefnum gjaldmiðli. Sending 1295.00 eða 12.95 mun leiða til villu eða rangrar upphæðar.

Margir greiðslumátar

Til að bjóða upp á marga tiltekna greiðslumáta, bættu mörgum reitum í transactions fylkið. Röðin á hýstu síðunni samsvarar röð fylkisins:

"transactions": [
  { "payment_method": "credit-card" },
  { "payment_method": "apple-pay" }
]

The payment_methods field on orders accepts at most one value. To offer multiple specific methods, always use the transactions array. If you need a reusable link with multiple payment methods, consider Payment Links instead, which support a true payment_methods array.

Skilavefslóðir

Eftir greiðslu er viðskiptavininum endurbeint eftir stöðu pöntunar og hvaða vefslóðir þú gafst upp:

Þegar bæði return_url og failure_url eru sett:
- cancelled, expired eða error → viðskiptavininum er vísað á failure_url
- Allar aðrar stöður → viðskiptavininum er vísað á return_url
Þegar aðeins return_url er sett:
- Allar stöður → viðskiptavininum er vísað á return_url

Notaðu failure_url til að sýna endurtilraunarsíðu eða aðstoðarsíðu fyrir misheppnaðar greiðslur, á meðan return_url sýnir staðfestingu pöntunar. Ef þú þarft aðeins einn áfangastað dugar return_url ein.

Hegðun hætta-við-hnapps

Hýsta greiðslusíðan inniheldur hætta-við-hnapp. Þegar viðskiptavinurinn smellir á hann er honum vísað á failure_url (ef gefin) eða return_url. Staða pöntunar verður cancelled. Staðfestu alltaf stöðu pöntunar gegnum API eða webhook-a frekar en að treysta eingöngu á endurbeininguna.

Tengdir endapunktar

Stofna pöntun — stofnaðu greiðslupöntun og fáðu payment_url
Sækja pöntun — athugaðu stöðu pöntunar eftir greiðslu

On this page