Upiti o statusu
Provjerite statuse narudžbi i transakcija
Svako plaćanje u Cost+ predstavljeno je narudžbom koja sadrži jednu ili više transakcija. Možete provjeriti trenutni status bilo koje narudžbe upitom na API, bilo anketiranjem ili oslanjanjem na webhookove.
Dohvaćanje statusa narudžbe
Pošaljite GET zahtjev na /v1/orders/\{id\}/ za dohvaćanje potpunog objekta narudžbe uključujući njezin trenutni status i sve povezane transakcije.
GET /v1/orders/b9ae6.../Iako anketiranje funkcionira za provjeru statusa narudžbe, webhookovi su preporučeni pristup za produkcijske integracije. Pružaju obavijesti u stvarnom vremenu bez opterećenja ponovljenih API poziva.
Statusi narudžbe
Narudžba prolazi kroz sljedeće statuse:
| Status | Konačan | Opis |
|---|---|---|
new | Ne | Narudžba je upravo stvorena. Nije napravljen nijedan pokušaj plaćanja. |
processing | Ne | Pokušaj plaćanja je u tijeku. Kupac možda dovršava 3D Secure ili drugi korak verifikacije. |
error | Da | Tehnički kvar završio je narudžbu. Izradite novu narudžbu ako kupac treba pokušati ponovno. |
completed | Da | Plaćanje je uspjelo. Možete ispuniti narudžbu. |
cancelled | Da | Narudžba je poništena, bilo od strane kupca ili putem API-ja. |
expired | Da | Narudžba je istekla prije uspješnog plaćanja. Zadano razdoblje isteka je 30 minuta. |
Samo statusi označeni kao Konačan = Da su terminalni. Narudžbe u statusu new, processing ili error još uvijek mogu prijeći u completed.
Primjer: Narudžba u obradi
Kada je kupac pokrenuo plaćanje, ali ono još nije dovršeno:
{
"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"]
}Primjer: Dovršena narudžba
Nakon uspješnog plaćanja, narudžba dostiž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"]
}Detalji transakcije
Svaka transakcija unutar narudžbe sadrži sljedeća ključna polja:
| Polje | Opis |
|---|---|
payment_method | Korišteni način plaćanja (npr. credit-card, ideal, apple-pay) |
payment_method_brand | Brend ili izdavatelj (npr. visa, mastercard, amex) |
payment_method_details | Objekt s detaljima specifičnim za način plaćanja kao što su posljednje četiri znamenke kartice, istek i ime vlasnika |
status | Status ove specifične transakcije |
amount | Iznos transakcije u manjoj jedinici ISO 4217 valute |
currency | Valuta transakcije |
Ne oslanjajte se isključivo na preusmjeravanje kupca na vaš return_url kao potvrdu plaćanja. Uvijek provjerite status narudžbe putem API-ja ili webhookom prije ispunjenja narudžbe.
Povezane krajnje točke
- Dohvati narudžbu — dohvatite potpuni objekt narudžbe i njezin trenutni status
- Popis narudžbi — prikažite narudžbe s filtriranjem po rasponu datuma