Poizvedbe o statusu
Preverjanje statusov naročil in transakcij
Vsako plačilo v Cost+ je predstavljeno z naročilom, ki vsebuje eno ali več transakcij. Trenutni status kateregakoli naročila lahko preverite s poizvedbo v API-ju, bodisi z rednim poizvedovanjem ali z zanašanjem na webhook-e.
Pridobivanje statusa naročila
Pošljite zahtevo GET na /v1/orders/\{id\}/ za pridobitev celotnega objekta naročila, vključno s trenutnim statusom in vsemi povezanimi transakcijami.
GET /v1/orders/b9ae6.../Čeprav redno poizvedovanje deluje za preverjanje statusa naročila, so webhook-i priporočen pristop za produkcijske integracije. Zagotavljajo obvestila v realnem času brez dodatnega bremena ponavljajočih se API klicev.
Statusi naročila
Naročilo napreduje skozi naslednje statuse:
| Status | Končni | Opis |
|---|---|---|
new | Ne | Naročilo je bilo pravkar ustvarjeno. Noben poskus plačila še ni bil izveden. |
processing | Ne | Poskus plačila je v teku. Stranka morda dokončuje 3D Secure ali drug korak preverjanja. |
error | ja | Tehnična napaka je končala naročilo. Če mora stranka poskusiti znova, ustvarite novo naročilo. |
completed | Da | Plačilo je bilo uspešno. Naročilo lahko izpolnite. |
cancelled | Da | Naročilo je bilo preklicano, bodisi s strani stranke ali prek API-ja. |
expired | ja | Naročilo je poteklo pred uspešnim plačilom. Privzeto obdobje poteka je 30 minut. |
Samo statusi označeni kot Končni = Da so terminalni. Naročila v statusu new, processing ali error se še vedno lahko spremenijo v completed.
Primer: Naročilo v obdelavi
Ko je stranka začela plačilo, vendar še ni dokončano:
{
"id": "b9ae6...",
"project_id": "proj_abc123",
"merchant_order_id": "my-order-id-1",
"created": "2024-01-01T12:00:00.000000+00:00",
"modified": "2024-01-01T12:01:30.000000+00:00",
"completed": null,
"expiration_period": "PT30M",
"status": "processing",
"currency": "EUR",
"amount": 1295,
"description": "My amazing order",
"return_url": "https://www.example.com",
"payment_url": "https://api.costplus.online/pay/...",
"webhook_url": "https://www.example.com/webhook",
"transactions": [
{
"id": "txn_001...",
"payment_method": "credit-card",
"payment_method_brand": "visa",
"status": "processing",
"amount": 1295,
"currency": "EUR"
}
],
"flags": ["is-test"]
}Primer: Dokončano naročilo
Ko je plačilo uspešno, naročilo doseže status completed:
{
"id": "b9ae6...",
"project_id": "proj_abc123",
"merchant_order_id": "my-order-id-1",
"created": "2024-01-01T12:00:00.000000+00:00",
"modified": "2024-01-01T12:02:15.000000+00:00",
"completed": "2024-01-01T12:02:15.000000+00:00",
"expiration_period": "PT30M",
"status": "completed",
"currency": "EUR",
"amount": 1295,
"description": "My amazing order",
"return_url": "https://www.example.com",
"payment_url": "https://api.costplus.online/pay/...",
"webhook_url": "https://www.example.com/webhook",
"transactions": [
{
"id": "txn_001...",
"payment_method": "credit-card",
"payment_method_brand": "visa",
"payment_method_details": {
"card_last_four": "4242",
"card_expiry_month": 12,
"card_expiry_year": 2026,
"card_holder_name": "J. Smith"
},
"status": "completed",
"amount": 1295,
"currency": "EUR"
}
],
"flags": ["is-test"]
}Podrobnosti transakcije
Vsaka transakcija znotraj naročila vsebuje naslednja ključna polja:
| Polje | Opis |
|---|---|
payment_method | Uporabljena plačilna metoda (npr. credit-card, ideal, apple-pay) |
payment_method_brand | Blagovna znamka ali izdajatelj (npr. visa, mastercard, amex) |
payment_method_details | Objekt s podrobnostmi, specifičnimi za metodo, kot so zadnje štiri številke kartice, veljavnost in ime imetnika |
status | Status te specifične transakcije |
amount | Znesek transakcije v manjši enoti ISO 4217 valute |
currency | Valuta transakcije |
Ne zanašajte se izključno na preusmeritev stranke na vaš return_url kot potrditev plačila. Vedno preverite status naročila prek API-ja ali webhook-a, preden izpolnite naročilo.
Povezane končne točke
- Pridobi naročilo — pridobi celoten objekt naročila in njegov trenutni status
- Seznam naročil — seznam naročil s filtriranjem po datumskem razponu