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é
- Cruthaíonn do fhreastalaí ordú trí POST /v1/orders/ a ghlaoch.
- Seolann an API URL ar ais atá dírithe ar an leathanach íocaíochta óstáilte.
- Atreorófar an custaiméir chuig an leathanach íocaíochta.
- Críochnaíonn an custaiméir an íocaíocht ar an leathanach óstáilte Cost+.
- Atreorófar an custaiméir ar ais chuig do
return_url(nófailure_urlle haghaidh íocaíochtaí teipthe). - Seolann Cost+ fógra webhook chuig do
webhook_urlle 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:
{
"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"
}{
"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:
{
"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" }
]
}{
"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éimse | Riachtanach | Cur Síos |
|---|---|---|
currency | Tá | Cód airgeadra ISO 4217 (m.sh., EUR, GBP, SEK) |
amount | Tá | Méid in aonad mionaoiseach ISO 4217 an airgeadra. Mar shampla, léirítear 12.95 EUR mar 1295 |
merchant_order_id | Níl | D'aitheantas tagartha féin don ordú |
return_url | Níl | URL chun an custaiméir a atreorú tar éis íocaíochta (réamhshocrú do gach stádas) |
failure_url | Níl | URL chun an custaiméir a atreorú ar stádas cancelled, expired, nó error (féach URLanna Fillidh thíos) |
locale | Níl | Teanga don leathanach íocaíochta. Tacaithe: en-GB, de-DE, nl-NL, nl-BE, fr-BE, sv-SE, no-NO, da-DK |
description | Níl | Cur síos ar an ordú, a thaispeántar don chustaiméir |
payment_methods | Níl | Scag 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_url | Níl | URL chun fógraí athraithe stádais a fháil |
expiration_period | Níl | Fad 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_urlagusfailure_urlsocraithe araon:cancelled,expired, nóerror→ atreorófar an custaiméir chuigfailure_url- Gach stádas eile → atreorófar an custaiméir chuig
return_url
-
Nuair nach bhfuil ach
return_urlsocraithe:- Gach stádas → atreorófar an custaiméir chuig
return_url
- Gach stádas → atreorófar an custaiméir chuig
Ú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_urla fháil - Ordú a Fháil — stádas an ordaithe a sheiceáil tar éis íocaíochta