Cost+Docs

Autorizacije, naplate i poništenja

Upravljajte tijekovima autorizacije, naplate i poništenja plaćanja

Neki načini plaćanja podržavaju dvostupanjski tijek: najprije autorizirajte (rezervirajte sredstva), zatim naplatite (prikupite sredstva) ili poništite (oslobodite rezervaciju).

Načini naplate

Postavite capture_mode na narudžbi za kontrolu kada se sredstva naplaćuju:

NačinPonašanje
manualVi eksplicitno naplaćujete kada ste spremni (npr. nakon isporuke). Ako ne naplatite prije isteka narudžbe, autorizacija je izgubljena i ne može se naplatiti.
delayedSredstva se automatski naplaćuju u trenutku isteka expiration_period.
POST /v1/orders/ (manual capture)
{
  "currency": "EUR",
  "amount": 5000,
  "capture_mode": "manual",
  "return_url": "https://www.example.com",
  "webhook_url": "https://www.example.com/webhook",
  "transactions": [
    {
      "payment_method": "credit-card"
    }
  ]
}

S manual naplatom morate naplatiti prije isteka roka narudžbe. Nakon isteka, autorizacija se oslobađa i sredstva se ne mogu naplatiti. Postavite odgovarajući expiration_period za vaš vremenski okvir ispunjenja.

Možete postaviti capture_mode na razini narudžbe bez navođenja transactions. Hosted stranica za plaćanje tada će prikazati samo načine plaćanja koji podržavaju navedeni način naplate.

Provjera iznosa dostupnih za naplatu

Prije naplate možete provjeriti koliko je dostupno za naplatu zahtijevanjem amount_details:

curl -u YOUR_API_KEY: \
  "https://api.costplus.online/v1/orders/{order_id}/?fields[]=amount_details"

Odgovor uključuje objekt amount_details:

{
  "amount": 5000,
  "amount_details": {
    "capturable": 5000,
    "captured": 0,
    "refundable": 0,
    "refunded": 0,
    "voidable": 5000,
    "voided": 0
  }
}

Stavke narudžbe

Kada koristite naplate i poništenja po stavci narudžbe, koristite ove tipove:

TipOpis
physicalFizički proizvod
discountIznos popusta
shipping_feeTroškovi dostave
sales_taxPorez na promet
digitalDigitalni proizvod
gift_cardPoklon kartica
store_creditKredit trgovine
surchargeNadoplata

Naplata plaćanja

Naplata po stavci narudžbe

POST /v1/orders/{id}/transactions/{transaction_id}/captures/orderlines
Request body
{
  "description": "Shipping item #1",
  "order_line": {
    "merchant_order_line_id": "item-001",
    "quantity": 1
  }
}

Naplata po iznosu

POST /v1/orders/{id}/transactions/{transaction_id}/captures/amount
Request body
{
  "description": "Partial capture",
  "amount": 2500
}

Poništenje plaćanja

Poništenje oslobađa autorizirana sredstva natrag kupcu.

Poništenje po stavci narudžbe

POST /v1/orders/{id}/transactions/{transaction_id}/voids/orderlines
Request body
{
  "description": "Voiding item #2",
  "order_line": {
    "merchant_order_line_id": "item-002",
    "quantity": 1
  }
}

Poništenje po iznosu

POST /v1/orders/{id}/transactions/{transaction_id}/voids/amount
Request body
{
  "description": "Partial void",
  "amount": 1500
}

Parametri upita

Dodajte parametre upita za uključivanje dodatnih detalja u odgovor:

ParametarOpis
?fields[]=order_line_detailsUključi raščlambu stavki narudžbe
?fields[]=amount_detailsUključi raščlambu iznosa

Optimistično zaključavanje

Krajnje točke za naplatu i poništenje podržavaju optimistično zaključavanje temeljeno na ETag-u putem zaglavlja if-match. Ovo sprječava uvjete utrke kada više sustava pokušava naplatiti istu transakciju.

Capture with optimistic locking
curl -X POST https://api.costplus.online/v1/orders/{id}/transactions/{tid}/captures/amount \
  -u {api_key}: \
  -H "Content-Type: application/json" \
  -H "if-match: \"etag-value\"" \
  -d '{"description": "Capture", "amount": 2500}'

Ako se ETag ne podudara (narudžba je izmijenjena od zadnjeg dohvaćanja), primit ćete odgovor 412 Precondition Failed.

Cost+ podržava jednu naplatu po autorizaciji, a poništenja se mogu obraditi samo prije bilo kakve naplate. Planirajte svoju strategiju naplate u skladu s tim.

Povezane krajnje točke

On this page