Forbróirí
Trí ghlao agus webhook.
Is checkout óstáilte é Gateway, mar sin tá an lánpháirtiú beag d'aon ghnó: cruthaigh ordú, seol an custaiméir chuig an leathanach, fíoraigh an toradh sínithe. Is é seo thíos an dromchla iomlán — is linne an UI íocaíochta, loighic na modhanna, 3-D Secure, na sparáin dhigiteacha agus na admhálacha le tógáil agus le coinneáil cothrom le dáta.
A struchtúr
An rud a bhfuil tú ag lánpháirtiú leis.
- REST thar HTTPS
- JSON isteach, JSON amach
- Eochracha API Bearer
- Eochracha idempotency
- Webhooks sínithe
- Cosaint athsheinm
- Modhanna tástála agus beo
- SDKanna iOS & Android
- Breiseáin stórais
- Réimsí leabaithe
Tosú tapa
Ó neamhní go hordú íoctha.
An cosán sásta ar fad. Tá suimeanna in aonaid bheaga, is leatsa na tagairtí, agus is é URL an checkout an áit a n-atreoraíonn tú an custaiméir. Eisítear bonn-URL an API le d'eochracha sandbox — easpórtáil é mar PROTOCORE_API_BASE agus ritheann na glaonna thíos díreach mar atá scríofa.
Cruthaigh an t-ordú
Glao amháin leis an suim, an t-airgeadra agus do thagairt féin. Is tusa a ghineann an eochair idempotency — seolann iarratas athdhéanta an bunordú ar ais in ionad dara ordú a chruthú.
curl -X POST "$PROTOCORE_API_BASE/v1/orders" \
-H "Authorization: Bearer $PROTOCORE_API_KEY" \
-H "Idempotency-Key: 9F21-0716" \
-H "Content-Type: application/json" \
-d '{
"amount": 4900,
"currency": "EUR",
"reference": "9F21-0716",
"line_items": [
{ "name": "Brand identity sprint", "amount": 3850 },
{ "name": "Typeface licensing", "amount": 600 },
{ "name": "Rush delivery", "amount": 400 }
],
"return_url": "https://arcstudio.ro/thanks"
}'Seol an custaiméir chuig an checkout
Tá URL checkout sa fhreagra ar do óstach checkout féin — an ceann a eisíodh le do sandbox, nó do fhearann féin tar éis duit é a phointeáil chugainn. Atreoraigh chuige é, nó oscail san SDK é; is ar an leathanach sin atá na modhanna, na sparáin dhigiteacha agus 3-D Secure, mar sin níl aon rud le tógáil ar do thaobh.
{
"id": "ord_2h4Kq9wRz",
"reference": "9F21-0716",
"amount": 4900,
"currency": "EUR",
"status": "pending",
"checkout_url": "https://<your-checkout-host>/c/2h4Kq9wRz"
}Fíoraigh an toradh sínithe
Nuair a chríochnaíonn an íocaíocht, sroicheann imeacht sínithe do chríochphointe. Fíoraigh an síniú i gcoinne do rúin webhook sula gcreideann tú aon ní, ansin comhlíon i gcoinne na tagartha atá ar eolas agat cheana.
{
"type": "order.paid",
"id": "evt_7Ka2Lm",
"created": "2026-07-23T09:41:02Z",
"data": {
"id": "ord_2h4Kq9wRz",
"reference": "9F21-0716",
"amount": 4900,
"currency": "EUR",
"method": "usdc",
"settlement": { "currency": "EUR", "amount": 4900, "rate": "0.9184" }
}
}Tagairt
Na críochphointí a úsáidfidh tú i ndáiríre.
Tá níos mó sna doiciméid, ach is é seo an tacar nach dtéann an chuid is mó de na lánpháirtithe thairis.
Webhooks
An méid a chloiseann do backend.
Iompraíonn gach imeacht tagairt an ordaithe a chruthaigh tú, ionas gur féidir le do láimhseálaí a bheith ina switch ar an gcineál agus ina chuardach ar do thaobh féin.
Seiceáil an síniú sula gcreideann tú an corp.
Iompraíonn gach seachadadh stampa ama agus síniú HMAC ar an gcorp amh. Déan comparáid in am seasta, diúltaigh d'aon rud níos sine ná do fhuinneog lamháltais, agus déileáil le id imeachta dúbailte mar rud atá láimhseáilte cheana — déanaimid iarracht arís ar fhreagraí nach 2xx iad, mar sin ba cheart do láimhseálaí a bheith idempotent freisin.
import { createHmac, timingSafeEqual } from "node:crypto";
export function verify(rawBody, header, secret) {
const [ts, sig] = header.split(",").map((p) => p.split("=")[1]);
const expected = createHmac("sha256", secret)
.update(`${ts}.${rawBody}`)
.digest("hex");
const a = Buffer.from(sig, "hex");
const b = Buffer.from(expected, "hex");
if (a.length !== b.length || !timingSafeEqual(a, b)) return false;
// Reject replays outside a five-minute window.
return Math.abs(Date.now() / 1000 - Number(ts)) < 300;
}Ráthaíochtaí
Na hairíonna ar féidir leat tógáil orthu.
Cruthuithe idempotent
Glacann gach cruthú ordaithe eochair idempotency. Seolann iarratas athdhéanta — tar éis teorann ama, imscaradh nó athsheachadadh scuaine — an bunordú ar ais in ionad muirear dhá uair.
Imeachtaí sínithe, cosanta ar athsheinm
Iompraíonn webhooks síniú HMAC le stampa ama agus id imeachta cobhsaí. Déantar iarracht arís le backoff go dtí go bhfreagraíonn do chríochphointe 2xx, ionas nach gcaillfear íocaíocht i bhfuinneog imscartha.
Tagairt amháin, ó thús go deireadh
Feictear an tagairt a sholáthraíonn tú agus an t-ordú á chruthú ar an checkout, san admháil, sa webhook, sa socraíocht agus in aon aisíocaíocht ina dhiaidh. Níl aon dara aitheantóir le mapáil idir córais.
Is é an cosán cóid céanna é an mód tástála
Ritheann eochracha tástála na sreafaí comhionanna i gcoinne seisiún tástála. An rud a théann thar tástáil, sin an rud a sheoltar — is é an difríocht na heochracha a sheolann tú, ní na críochphointí a ghlaonn tú.
Sonraí tástála
Conas na cosáin thábhachtacha a thástáil.
Tá cárta tástála ag gach cosán thíos, liostaithe i dteannta d'eochracha nuair a eisítear an sandbox — tá na huimhreacha sonrach do gach sandbox in ionad a bheith foilsithe anseo, ionas go bhfanfaidh siad cruinn nuair a athraíonn raonta tástála na scéimeanna. Tá an t-iompar cinntitheach ar aon nós: is féidir le tástáil diúltú a dhearbhú chomh héasca le rath.
Faigh eochracha agus tosaigh.
Ceannaí sandbox le heochracha API, rúin webhook agus gach modh casta air — móide an tagairt iomlán, ionas gur féidir le d'fhoireann comhtháthú a dhéanamh sular síníodh aon rud.