Mearthosnú
Glac le do chéad íocaíocht i 5 nóiméad
Treorófar tú tríd an treoir seo chun íocaíocht thástála a chruthú agus a chríochnú ag úsáid API Cost+. Faoi dheireadh, beidh comhtháthú oibre agat ar féidir leat tógáil air.
Réamhriachtanais
- Cuntas Cost+ le suíomh gréasáin gaineamhchláir — cruthaigh ceann sa Tairseach Ceannaithe
- D'eochair API gaineamhchláir (le fáil faoi Suíomhanna Gréasáin → do shuíomh gréasáin gaineamhchláir → Comhtháthú)
Níl tú cinnte conas d'eochair API a fháil? Féach ar Do Chomhtháthú a Thástáil le haghaidh treoracha socraithe mionsonraithe.
Céim 1: Ordú a Chruthú
Seol iarratas POST chun ordú íocaíochta a chruthú. Cuir d'eochair API gaineamhchláir in ionad YOUR_API_KEY:
curl -X POST https://api.costplus.online/v1/orders/ \
-u YOUR_API_KEY: \
-H "Content-Type: application/json" \
-d '{
"currency": "EUR",
"amount": 1295,
"merchant_order_id": "my-first-order",
"description": "Test order",
"return_url": "https://example.com/return",
"webhook_url": "https://example.com/webhook",
"transactions": [
{
"payment_method": "credit-card"
}
]
}'Is slánuimhir é an amount i mionaonad ISO 4217 an airgeadra. I gcás EUR, ciallaíonn 1295 12.95 EUR.
Seolann an API an réad ordaithe iomlán ar ais. Is iad na réimsí tábhachtacha ná id, status, agus an payment_url taobh istigh den idirbheart:
{
"id": "4851e31c-4137-4e91-95ef-1df945ee76a2",
"status": "new",
"currency": "EUR",
"amount": 1295,
"merchant_order_id": "my-first-order",
"description": "Test order",
"return_url": "https://example.com/return",
"webhook_url": "https://example.com/webhook",
"created": "2026-01-15T12:00:05.433502+00:00",
"modified": "2026-01-15T12:00:05.553125+00:00",
"expiration_period": "PT1H",
"transactions": [
{
"id": "d291f03f-a406-428a-967a-4895a46e03fd",
"payment_method": "credit-card",
"status": "new",
"amount": 1295,
"currency": "EUR",
"payment_url": "https://api.costplus.online/pay/4851e31c.../select-payment-method/credit-card/d291f03f...",
"is_capturable": false,
"expiration_period": "PT30M"
}
]
}Braitheann cruth an fhreagra ar an méid a sheolann tú:
- Le heagar
transactions(an mearthosach seo): tápayment_urldá chuid féin ag gach réad idirbhirt. Atreoraigh an custaiméir ann. - Gan
transactions: táorder_urlag barr-leibhéal san ordú ina ionad sin, agus roghnaíonn an custaiméir modh íocaíochta ar leathanach óstáilte Cost+. Féach an treoir don Hosted Payment Page don sreabhadh sin.
Sábháil an id — beidh sé ag teastáil uait i gCéim 3.
Céim 2: An Íocaíocht Thástála a Chríochnú
- Oscail an
payment_urlón bhfreagra i do bhrabhsálaí - Ar an leathanach íocaíochta, cuir isteach sonraí an chárta tástála:
| Réimse | Luach |
|---|---|
| Uimhir chárta | 4111 1111 1111 1111 |
| Éag | Aon dáta amach anseo (m.sh. 12/28) |
| CVC | Aon 3 dhigit (m.sh. 123) |
- Seol an íocaíocht
- Atreorófar ar ais tú chuig do
return_url
Ná bí ag brath ar an atreorú amháin chun íocaíocht a dhearbhú. D'fhéadfadh an custaiméir a mbrabhsálaí a dhúnadh sula n-atreorófar iad. Fíoraigh i gcónaí tríd an API (Céim 3) nó webhookeanna (Céim 4).
Céim 3: An Íocaíocht a Fhíorú
Faigh an t-ordú chun a dhearbhú gur críochnaíodh é:
curl -u YOUR_API_KEY: \
https://api.costplus.online/v1/orders/4851e31c-4137-4e91-95ef-1df945ee76a2/Breathnaíonn íocaíocht rathúil mar seo:
{
"id": "4851e31c-4137-4e91-95ef-1df945ee76a2",
"status": "completed",
"currency": "EUR",
"amount": 1295,
"merchant_order_id": "my-first-order",
"completed": "2026-01-15T12:02:30.123456+00:00",
"transactions": [
{
"id": "d291f03f-a406-428a-967a-4895a46e03fd",
"payment_method": "credit-card",
"status": "completed",
"amount": 1295,
"currency": "EUR",
"payment_method_details": {
"truncated_pan": "1111",
"card_expiry": "122028"
}
}
]
}Tá status an ordaithe "completed" — d'éirigh leis an íocaíocht.
Céim 4: An Webhook a Láimhseáil (Molta)
Nuair a athraíonn stádas na híocaíochta, seolann Cost+ iarratas POST chuig do webhook_url:
{
"event": "status_changed",
"order_id": "4851e31c-4137-4e91-95ef-1df945ee76a2"
}Nuair a fhaigheann tú é seo:
- Glaoigh
GET /v1/orders/{order_id}/chun an stádas reatha a fhíorú (ná bí ag brath ar an sonraí webhook amháin riamh) - Seol HTTP
200ar ais chun fáiltiú a admháil - Comhlíon an t-ordú má tá an stádas
"completed"
Le haghaidh forbartha áitiúil, úsáid tollán cosúil le ngrok chun do fhreastalaí áitiúil a nochtadh agus webhookeanna a fháil.
Féach ar an treoir Webhookeanna le haghaidh loighic atrialacha, dea-chleachtais, agus sonraí sonraí.
Rogha Eile: Naisc Íocaíochta
Mura bhfuil loighic atreoraithe ar thaobh an fhreastalaí ag teastáil uait, tugann naisc íocaíochta cosán níos simplí. Cruthaigh nasc, roinn an URL le do chustaiméir, agus seiceáil an stádas níos déanaí.
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": 2500,
"currency": "EUR",
"description": "Invoice #1234"
}'Áirítear payment_url san fhreagra ar féidir leat é a roinnt trí ríomhphost, SMS, nó comhrá. Is féidir leis an gcustaiméir iarracht a dhéanamh an íocaíocht a dhéanamh arís agus arís eile (suas le 25 uair) go dtí go n-éagann an nasc nó go n-éiríonn leis an íocaíocht.
Féach ar an treoir Naisc Íocaíochta le haghaidh an tsreabha oibre iomláin.
Céard Atá ar Aghaidh?
Tá do chéad íocaíocht críochnaithe agat. Seo na chéad chéimeanna eile:
- Leathanach Íocaíochta Óstáilte — tagairt iomlán HPP le gach réimse iarratais agus roghanna
- Íocaíochtaí Athfhillteacha — socraigh síntiúis agus billeáil sceidealaithe
- Íocaíochtaí Aon-Chliceála — seiceáil amach tapa do chustaiméirí a fhilleann
- Údarú / Gabháil / Neamhniú — údaraigh ar dtús, gabh níos déanaí (m.sh. nuair a sheoltar)
- Aisíocaíochtaí — próiseáil aisíocaíochtaí iomlána agus páirteacha
- SDKanna — leabharlanna oifigiúla do Node.js, Python, PHP, Java/Kotlin, C#/.NET, agus Ruby
- Breiseáin — comhtháthuithe réamhthógtha do Shopify, WooCommerce, Magento, agus tuilleadh
Críochphointí Gaolmhara
- Ordú a Chruthú — tagairt API iomlán do chruthú ordaithe
- Ordú a Fháil — sonraí agus stádas ordaithe a fháil
- Nasc Íocaíochta a Chruthú — naisc íocaíochta in-athúsáidte a chruthú