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://api.costplus.online/pay/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://api.costplus.online/pay/4851e31c.../select-payment-method/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æð í ISO 4217 minni einingu gjaldmiðilsins. Til dæmis er 12,95 EUR táknað 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	Sía í einn greiðslumáta (t.d. `["credit-card"]`). Slepptu til að sýna allar virkar aðferðir. Fyrir margar sérstakar aðferðir, notaðu `transactions` fylkið í staðinn
`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 heiltala í ISO 4217 minnieiningu gjaldmiðilsins. Fyrir EUR þýðir 1295 12,95 EUR; Núll- og þriggja aukastafa gjaldmiðlar nota sinn eigin ISO 4217 veldisvísi. Ef tugastafur er gefinn út eins og 1295.00 eða 12.95 mun það leiða til villu eða rangrar gjaldfærslu.

Margir greiðslumátar

Það eru tvær leiðir til að stjórna hvaða greiðslumáta birtast á hýstu síðunni:

Valkostur A — payment_methods (stök sía). Farðu í gegnum einþátta fylki til að takmarka pöntunina við einn greiðslumáta. Slepptu reitnum alveg til að sýna allar aðferðir sem eru virkar fyrir reikninginn þinn.

Valkostur B — transactions fylki (mælt með fyrir margar aðferðir). Bættu við einni færslu fyrir hvern greiðslumáta. Hver viðskipti fær sína eigin payment_url og aðferðirnar birtast í fylkisröð á hýstu síðunni:

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

payment_methods reiturinn á pöntunum tekur að hámarki eitt gildi. Til að bjóða upp á margar sérstakar aðferðir, notaðu alltaf transactions fylkið. Ef þú þarft einnota hlekk með mörgum greiðslumátum skaltu íhuga Payment Links í staðinn, sem styðja sanna payment_methods fylki.

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

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

On this page