Cost+Docs

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:

StatusKonačanOpis
newNeNarudžba je upravo stvorena. Nije napravljen nijedan pokušaj plaćanja.
processingNePokušaj plaćanja je u tijeku. Kupac možda dovršava 3D Secure ili drugi korak verifikacije.
errorDaTehnički kvar završio je narudžbu. Izradite novu narudžbu ako kupac treba pokušati ponovno.
completedDaPlaćanje je uspjelo. Možete ispuniti narudžbu.
cancelledDaNarudžba je poništena, bilo od strane kupca ili putem API-ja.
expiredDaNarudž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:

PoljeOpis
payment_methodKorišteni način plaćanja (npr. credit-card, ideal, apple-pay)
payment_method_brandBrend ili izdavatelj (npr. visa, mastercard, amex)
payment_method_detailsObjekt s detaljima specifičnim za način plaćanja kao što su posljednje četiri znamenke kartice, istek i ime vlasnika
statusStatus ove specifične transakcije
amountIznos transakcije u manjoj jedinici ISO 4217 valute
currencyValuta 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

On this page