Ten typ transakcji jest dostępny dla: Kart płatniczych oraz BLIKA.
Celem tej operacji jest zwrot kwoty poprzedniej płatności, uznanie rachunku posiadacza karty i obciążenie rachunku sprzedawcy.
Zwrot jest wykonywany w odniesieniu do poprzedniej płatności, odwołując się do jej identyfikatora transakcji poprzez wysłanie żądania POST przez HTTPS do punktu końcowego /payments/{transactionID}/refund.
Zwrot może zostać wykonany:
- dla zakupu (PURS),
- dla przechwyconej preautoryzacji (AUTH -> Capture),
i może być:
- pełnym zwrotem pieniedzy, gdy całkowita kwota zakupu zostanie zwrócona posiadaczowi karty,
- częściowym zwrotem, gdy posiadaczowi karty zwracana jest suma częściowa całkowitego zakupu.
Wygeneruj transakcję:
POST https://stargate-cer.qly.site1.sibs.pt/api/v1/payments/{transactionID}/refund
Parametry nagłówka
Authorization
Mandatory
Bearer Token. Based on OAuth2 authentication performed in a pre-step.
Show more
x-ibm-client-id
Mandatory
Token that identifies a client organization. It is provided during onboarding process and must be used in every call.
Show more
Parametry żądania
merchant
Obowiązkowy
Opcjonalny element służący do sprawdzania statusu transakcji.
Show more
terminalID
Numeryczny [<= 10 znaków]
Obowiązkowy
Identyfikacja terminala handlowego
Show more
kanał
Obowiązkowy
Kanał sprzedawcy, możliwa wartość „Sieć”
Show more
merchantTransactionID
Obowiązkowy
Unikalny identyfikator używany przez sprzedawcę.
Show more
transakcja
Obowiązkowy
Opcjonalny element służący do sprawdzania statusu transakcji.
Show more
transactionTimeStamp
Obowiązkowy
Znacznik czasu transakcji.
Show more
amount
Obowiązkowy
Parametr określający wartość i walutę transakcji.
Show more
waluta
Kod waluty
SO 4217 Alpha-3 Code
Obowiązkowy
Show more
originalTransaction
Obowiązkowy
Parametr z oryginalną transakcją.
Show more
Id
Obowiązkowy
Unikalny identyfikator pierwotnej transakcji.
Show more
data czas
Obowiązkowy
Znacznik czasu oryginalnej transakcji.
Show more
Oto przykład:
Nagłówek żądania:
Autorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCIgOiAiSldUIiwia2lkIiA6I (...)
X-IBM-Client-Id: b4480347-9fc8-4790-b359-100a99c60ea3
Content-Type: application/json
{
"merchant": {
"terminalId": 24,
"channel": "web",
"merchantTransactionId": "BO_Order Id: c9876bcasd"
},
"transaction": {
"transactionTimestamp": "2022-05-29T18:23:41.367Z",
"description": "This is a refund request",
"amount": {
"value": 10,
"currency": "PLN"
},
"originalTransaction": {
"id": "mvuy3dh3wucpsi4389fh",
"datetime": "2022-05-29T17:23:36.105Z"
}
}
}
Tylko dla operacji zwrotu BLIK
Po zakończeniu operacji zwrotu, powinno się otrzymać paymentStatus oczekujący.
Aby uzyskać najnowszą aktualizację, należy następnie wykonać operację “Get Status”.
Nagłówek Authorization HTTP jest ustawiony na Bearer token (token okaziciela), jaki został użyty podczas początkowej realizacji transakcji (Checkout).