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čin | Ponašanje |
|---|---|
manual | Vi 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. |
delayed | Sredstva se automatski naplaćuju u trenutku isteka expiration_period. |
{
"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:
| Tip | Opis |
|---|---|
physical | Fizički proizvod |
discount | Iznos popusta |
shipping_fee | Troškovi dostave |
sales_tax | Porez na promet |
digital | Digitalni proizvod |
gift_card | Poklon kartica |
store_credit | Kredit trgovine |
surcharge | Nadoplata |
Naplata plaćanja
Naplata po stavci narudžbe
POST /v1/orders/{id}/transactions/{transaction_id}/captures/orderlines{
"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{
"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{
"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{
"description": "Partial void",
"amount": 1500
}Parametri upita
Dodajte parametre upita za uključivanje dodatnih detalja u odgovor:
| Parametar | Opis |
|---|---|
?fields[]=order_line_details | Uključi raščlambu stavki narudžbe |
?fields[]=amount_details | Uključ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.
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
- Naplata po iznosu — naplatite određeni iznos s autorizirane narudžbe
- Naplata po stavci narudžbe — naplatite određene stavke narudžbe
- Poništenje po iznosu — poništite određeni iznos s autorizirane narudžbe
- Poništenje po stavci narudžbe — poništite određene stavke narudžbe