Cost+Docs

Leathanach Íocaíochta Óstáilte (HPP)

Glac le híocaíochtaí ag úsáid leathanach íocaíochta óstáilte Cost+

Is foirm íocaíochta Cost+ atá comhlíontach le PCI DSS é an Leathanach Íocaíochta Óstáilte (HPP). Ligeann sé duit íocaíochtaí a ghlacadh gan sonraí íogaire cártaí a láimhseáil ar do fhreastalaithe féin. Cruthaíonn tú ordú tríd an API, atreorófar an custaiméir chuig an leathanach óstáilte, agus filleann siad ar do shuíomh tar éis na híocaíochta.

Conas a Oibríonn Sé

  1. Cruthaíonn do fhreastalaí ordú trí POST /v1/orders/ a ghlaoch.
  2. Seolann an API URL ar ais atá dírithe ar an leathanach íocaíochta óstáilte.
  3. Atreorófar an custaiméir chuig an leathanach íocaíochta.
  4. Críochnaíonn an custaiméir an íocaíocht ar an leathanach óstáilte Cost+.
  5. Atreorófar an custaiméir ar ais chuig do return_url (nó failure_url le haghaidh íocaíochtaí teipthe).
  6. Seolann Cost+ fógra webhook chuig do webhook_url le stádas an ordaithe.

Tá an leathanach íocaíochta óstáilte go hiomlán comhlíontach le PCI DSS. Ní gá duit uimhreacha amha cártaí ná sonraí íogaire íocaíochta a láimhseáil ar do fhreastalaithe riamh.

Ordú a Chruthú

Tá dhá chur chuige ann chun an HPP a úsáid:

Cur Chuige 1: Gach Modh Íocaíochta a Thaispeáint (Is Simplí)

Cruthaigh ordú gan transactions a shonrú. Áirítear order_url san fhreagra — atreorófar an custaiméir ansin agus feicfidh siad gach modh íocaíochta atá cumasaithe do do chuntas:

Request
{
  "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"
}
Response
{
  "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"
}

Atreorófar an custaiméir chuig an order_url. Ar an leathanach óstáilte, taispeántar gach modh íocaíochta cumasaithe.

Cur Chuige 2: Modhanna Íocaíochta a Réamhroghnú

Cruthaigh ordú le eagar transactions chun smacht a fháil ar na modhanna íocaíochta a thaispeántar agus san ord a dtaispeántar iad. Áirítear payment_method i ngach idirbheart, agus seolann an freagra payment_url ar ais taobh istigh de réad an idirbhirt:

Request
{
  "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" }
  ]
}
Response
{
  "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.../"
    }
  ]
}

Atreorófar an custaiméir chuig an payment_url ón idirbheart.

Má chuireann tú iontráil amháin san eagar transactions ar fáil, téitear go díreach chuig an modh íocaíochta sin gan scáileán roghnaithe a fheiceáil. Bíonn "is-test" san eagar flags agus eochair API gaineamhchláir á úsáid.

Réimsí Iarratais

RéimseRiachtanachCur Síos
currencyTáCód airgeadra ISO 4217 (m.sh., EUR, GBP, SEK)
amountTáMéid in aonad mionaoiseach ISO 4217 an airgeadra. Mar shampla, léirítear 12.95 EUR mar 1295
merchant_order_idNílD'aitheantas tagartha féin don ordú
return_urlNílURL chun an custaiméir a atreorú tar éis íocaíochta (réamhshocrú do gach stádas)
failure_urlNílURL chun an custaiméir a atreorú ar stádas cancelled, expired, nó error (féach URLanna Fillidh thíos)
localeNílTeanga don leathanach íocaíochta. Tacaithe: en-GB, de-DE, nl-NL, nl-BE, fr-BE, sv-SE, no-NO, da-DK
descriptionNílCur síos ar an ordú, a thaispeántar don chustaiméir
payment_methodsNílScag go modh íocaíochta amháin (m.sh. ["credit-card"]). Fág gach modh cumasaithe a thaispeáint. Le haghaidh modhanna sonracha iolracha, bain úsáid as an eagar transactions ina ionad sin
webhook_urlNílURL chun fógraí athraithe stádais a fháil
expiration_periodNílFad ISO 8601 d'éag an ordaithe. Is é an réamhshocrú ná PT30M (30 nóiméad)

Is slánuimhir é an réimse amount i mionaonad ISO 4217 an airgeadra i gcónaí. I gcás EUR, ciallaíonn 1295 12.95 EUR; Úsáideann airgeadraí nialasacha agus trí dheachúla a n-easpónant ISO 4217 féin. Má ritheann tú luach deachúlach mar 1295.00 nó 12.95 beidh earráid nó muirear mícheart.

Modhanna Íocaíochta Iolracha

Tá dhá bhealach ann chun na modhanna íocaíochta atá le feiceáil ar an leathanach a óstáil a rialú:

Rogha A — payment_methods (scagaire singil). Cuir eagar ar aon eilimint amháin chun an t-ordú a shrianadh go modh íocaíochta amháin. Fág amach an réimse ina iomláine chun gach modh atá cumasaithe do do chuntas a thaispeáint.

Rogha B — eagar transactions (molta le haghaidh modhanna iolracha). Cuir iontráil amháin leis in aghaidh an mhodha íocaíochta. Faigheann gach idirbheart a payment_url féin, agus tá na modhanna le feiceáil in ord eagair ar an leathanach óstach:

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

Glacann an réimse payment_methods ar orduithe luach amháin ar a mhéad. Chun modhanna sonracha iolracha a thairiscint, úsáid an t-eagar transactions i gcónaí. Má theastaíonn nasc ath-inúsáidte uait le modhanna íocaíochta iolracha, smaoinigh ar Naisc Íocaíochta ina ionad sin, a thacaíonn le fíor-eagar payment_methods.

URLanna Fillidh

Tar éis íocaíochta, atreorófar an custaiméir bunaithe ar stádas an ordaithe agus na URLanna a chuir tú ar fáil:

  • Nuair atá return_url agus failure_url socraithe araon:

    • cancelled, expired, nó error → atreorófar an custaiméir chuig failure_url
    • Gach stádas eile → atreorófar an custaiméir chuig return_url
  • Nuair nach bhfuil ach return_url socraithe:

    • Gach stádas → atreorófar an custaiméir chuig return_url

Úsáid failure_url chun leathanach atrialacha nó tacaíochta a thaispeáint d'íocaíochtaí teipthe, agus taispeánann return_url dearbhú ordaithe. Mura bhfuil ach ceann scríbe amháin ag teastáil, is leor return_url amháin.

Iompraíocht an Chnaipe Ceala

Tá cnaipe ceala ar an leathanach íocaíochta óstáilte. Nuair a chliceálann an custaiméir é, atreorófar iad chuig failure_url (má cuireadh ar fáil é) nó return_url. Aistreoidh stádas an ordaithe go cancelled. Fíoraigh stádas an ordaithe i gcónaí tríd an API nó webhookeanna seachas a bheith ag brath ar an atreorú amháin.

Críochphointí Gaolmhara

  • Ordú a Chruthú — ordú íocaíochta a chruthú agus an payment_url a fháil
  • Ordú a Fháil — stádas an ordaithe a sheiceáil tar éis íocaíochta

On this page