Cost+Docs

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:

StatusKončniOpis
newNeNaročilo je bilo pravkar ustvarjeno. Noben poskus plačila še ni bil izveden.
processingNePoskus plačila je v teku. Stranka morda dokončuje 3D Secure ali drug korak preverjanja.
errorjaTehnična napaka je končala naročilo. Če mora stranka poskusiti znova, ustvarite novo naročilo.
completedDaPlačilo je bilo uspešno. Naročilo lahko izpolnite.
cancelledDaNaročilo je bilo preklicano, bodisi s strani stranke ali prek API-ja.
expiredjaNaroč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:

PoljeOpis
payment_methodUporabljena plačilna metoda (npr. credit-card, ideal, apple-pay)
payment_method_brandBlagovna znamka ali izdajatelj (npr. visa, mastercard, amex)
payment_method_detailsObjekt s podrobnostmi, specifičnimi za metodo, kot so zadnje štiri številke kartice, veljavnost in ime imetnika
statusStatus te specifične transakcije
amountZnesek transakcije v manjši enoti ISO 4217 valute
currencyValuta 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

On this page